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f 音里吉里/ KAGJ に興味をも〇ていただき、35りがとうございます。 
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r 吉里吉里」は、 rajs」 というプログラミング 言語を使って マルチメディア タイ トルを 作 
るための ツールです。 「 KAG 」 はその「吉里吉里」 をノベル.アドベンチャーゲームと して 動 
作させるための スクリプト群です。 

この本は「吉里吉里/ KAG」 でゲームを作ろうと考えている方を対象にしています。前半、 
「KAG」 について PIA 少尉さんに解説いただき、後半は私 (W.Dee) が 「TJS」 について解説 
しています。 

「KAGJ は、ノベル.アドベンチャーゲームを、簡単なテキスト.ファイルの記述で制作 
できるのです。一方、 「TJS」 は、 Java や JavaScript といった言語に似たプログラミング言語 
で、 「KAGj よりもより F 吉里吉里」本体や：^ンピュータ側に近い操作を行ないます。 

「KAGJ でできることは広く、その機能を知るにつれて、きっと想像太 T をかきたてられる 
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と思 t 、ます^そのうえ、何か特別なことをやりたいと思った場合は、 「TJSJ を使ってより詳 
細に r 吉里吉里 j を操作することができます S また、 KAG 自体が dJSj で記述されている 
ため、改繫が比較的容易です。「吉里吉里/ KAG」 においては、ごの 「KAGJ と 「TJS」 を組 


み合わせて使えることが、大きな特徴です， 


できることが広いというと、何か難しそ#で踏み入るには勇気が要るように思われるかも 
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しれません。しかし、最初の一歩を踏み出_あとはどん if んと進んでいけるものだと思 
います。この本がその道しるべとなり、皆様のお役に立てることを顧います。 
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「吉里 f 里」は、もともとは自分 （W.Dee) 自身が使うために作られ、「目的 J を達成す 
るための「手段」でした。それがいつのまにか「手段」から「目的」に変わり、ついにはこ 
のたびのように本を書かせていただけることにまでなったのは、自分自身でも驚くべきこと 
である&思っています。 KAG 編の執筆に快く応じてくださった PIA 少尉さん、書籍への収録 
を許可しくださった方々に感謝いたします。 

また、 f 吉里吉里/ KAGJ は愁一人の力で作り上げられたもめではありません。多くの方々 
のご意見をうけて作り上げられたものです。作品を世に公爵された方々、作品を製作中の 
方々、デ/すッグに協力してぐださった方々、•りがたい助言を下ざった方々、奇行に付き合 
って下さった方々、ず吉_吉里/ KAG 推進委員会」の方々、 IRC チャンネル 「#kMkiriircJ の 
方々、そしてこの本を読んでくださる方々に、深く感謝の意を表わしたいと思います。 








全_0ク U ェイターの皆さん、最近ゲームを作つていますか？ 


PIA 少尉こと私は2000年の冬に ri 999 ChristmasEve 』 というテキストアドベンチャー•ゲ 
ームを公開しました。 

ゲーム制作は初めてという素人集団を、ディレクションは初めてという少尉が指揮して完 
成させた稚拙な処女作なのですが、ベクターデザインさんのサイトにアップした結果、2年間 
で150,000ダウンロードを突破するという望外な反響をいただきました。 


実はこのゲーム、「吉里吉里/ KAG 」 と呼ばれるフリーソフトのアドベンチャー•ゲーム 
作成ツールで制作させてもらったのですが、ある日、当の「吉里吉里/ KAG 開発者」の 
W . Dee さんから一通のメールが舞い込んできました0 


K. 


W.Dee 

少翁 

W.Dee 

少尉 

W.Dee 


少尉 


少尉は、解り■咖」のことを知パ へ 

は、はあ（そんなわけないと思うけどなぁ？） 

『1999 ChristmasEve 』 もとりあえず好評みたいだしね。 

お' おかげさまで0 

というわけでお願いなんですけど、「吉里吉里/ KAGJ の使い方を全国のク 
リ: t イターさん向けの原稿として害いてくれません？ 

ぎよえ！、 (><)/ 


少尉の恩人でもあり師匠でもある W . Dee さんの恩を裏切るわけにはまいりません。返事は 
一つでした。 

こうして少尉は、自分にそんな大役が務まるのかも半信半疑のま_、原稿執筆を承諾した 
のでありま fo 

少尉もまだまだ KAG 使いとしては半人前ですが、少しでも「本物の KAG 使い」を目指し 
て日夜 KAG のシナリオ•スクリプトと取り組んでいる皆さんのお役に立てれば幸 I 、です。 


華麗なる21世紀のフルカラー対応 AVG & ノベル作成ソフトを画指して躍進を統ける T 吉 
里吉里/ KAGJ を、今後ともどうぞよろしぐお願いします。 


構浜かまいたちフアンクラブ代表 PIA 少尉 筆 
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この章では「吉里吉里/ KAGJ の紹介と、使う前 
に必要な最低限の準備につし、て解説します。 















KAG を使う前に 

. じしブ、 ' へ ' ぐ： 
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擄 ii した〇當蠆 t 改良 

>_ア隹ンブラ. 
cm # 窗擄麵磨できる 
««鳙のひとつひとつ 
に ニー も ニック （_臞） 
奢鳙てたアセンブ 

巧*鷓で書かれ炎ブロ 
グラム t 韉械賴に鼸釈 
す綦もめ。 



「吉里吉里」は、 「 TJS 」 と呼ばれる独自のスクリプト言語を持つプログラ 
厶 • エンジンです。 

「吉里吉里」はエンジンなので、それ単体では何もしませんが、動作命令 
をプログラムした 「 TJS スクリプト」を与えてやることにより、 Windows 上で 
動作するさまざまなアプリケーションやゲームとして利用することができます。 

ただ、 TJS 自体は JavaScript に似ているとは言え、私のようなプログラマー 
でな t ゝ一般庶民にはやや難しく感じられます。 

「プログラムを組むプログラマー」一これは、時代がいくら変わっても、モ 
ノを創ることを夢見るクリエイターの卵にとっては、憧れの対象であることに 
変わりありません。 

もちろん、プログラムがスイスイと書ければこんなに嬉しいことはありませ 
ん。「あんな効果」や「こんな演出」なども、「よ一し。おいらがチョチョイの 
チョイとプログラム書いて…」って、あなた、それが簡単にできれば誰も苦労 
はしません。 

たしかに、「 C ++」 * や「アセンブラ」 * などのプログラム言語を駆使すれば 
何でもできるでしょうが、言語の特性や命令•構文などを熟知しなくては、最 
初の一歩すら踏み出せません。また、「別にプログラマーになるつもりはない。 
楽をしてカッコいいゲームを作りたいだけだ」という人には、この壁はチョモ 
ランマのように高く聳え立つ人跡未踏の（しかも苦労してまで登ろうとは思わ 
ない）冬山にすぎません。 

そこで、 W . Dee 氏は、 TJS を使い、ゲーム制作に必要と思われる命令群を 
持つキットを作りました。これが 「 KAG 」 です。 

ちなみに、 KAG は 「 KirikirLAdventure _ Game _ system 」 の略であり、正式 
には 『 KAG システム』と呼びますが、ここでは便宜上 「 KAG 」 と呼ぶことに 
します。 

KAG で書かれたスクリプトは KAG で解釈された後に、 「 TJS 」 に引き渡さ 
れ、「吉里吉里」をアドベンチャー•ゲームやノベルゲームとして動作させる 
ことができます。 








0-1 「吉里吉里/ KAGJ とは？ 


大切なことを言い忘れていましたが、「吉里吉里/ KAG 」 はフリーソフトです。 
フリーソフトはもちろん、市販品や同人作品など、お金を取るための作品に 
「吉里吉里/ KAG 」 を利用しても、 W . Dee さんにお金を払う必要はありませ 
ん。 

さあ、あなたもこの無料にして最高のゲーム制作ツール『吉里吉里/ KAG 』 
を使って、あなたの胸に秘めた想いを形にしてみませんか？ 


「吉里吉里/ KAG」 の自由度の高さ 


さて、私が吉里吉里/ KAG のどこに心底惚れ込んでいるかといえば、ひと 
えに「自由度と難易度のバランスが絶妙」な点です。 

普通、簡単なゲーム制作ツールは、簡単な故に制限が多いです。 

たとえば、こんな感じですね 0 _ 

• 同時に発音できる効果音は2つまで 
• 変数は全部で255個まで 
，画像を表示できる最大数は3枚まで 


このように、“簡単操作”を謳う制作ツールに背後霊のようにくっついてい 
る「開発者の一方的都合による変な仕様」に泣かされたクリエイターも多い 
と思います。 

もちろん、この背後霊的制限は、操作性や制作工程を簡易化するためには 
非常に大切なことです。でも、でもでもでもですよ、あまりにも制限ばかり目 
に付いてしまい、「あれもダメ」「これもダメ！」って言われたら、親の束縛か 
ら逃避するために家出を敢行する中学生ではありませんが、「やってられっか 
よ！」って制作する意欲も失せちゃいますよね。 

私は「凝ったゲームを作りたい。でも、プログラムを勉強するほどじやな 
い。だからといって、制限の多い簡易ツールは使いたくないなぁ」という一人 
でした。ですから、吉里吉里/ KAG に出会ったときには、心底驚きました。 

ツールがゲーム 制作者に課す“制限”と呼ばれるものがほとんど存在しなか 
ったのですから。 







「画像レイヤーを 10 枚使いたい？ どうぞ」 

「変数を100個使いナこい？ 使う場所があれば、けっこうですよ」 

「選択肢の数を自由に増やしたり減らしたりしたい？ 問題ありませんわ」 
「セーブ•データの保存可能数を50個にしたい？まあ、ユーザー思いなこと 
ですね。もちろんかまいませんよ」 

「メニューをいろいろと変更したい？ 分かりました。システム的な部分も開 
放していますから、どうぞご自由に調整してください」 



皆さんは、「制限が存在しないってことは、相当難解なスクリプトを学ばな 
いといけないんだろうなあ」と思っているでしょう0 

さにあらず。「吉里吉里/ KAG 」 は、初心者であっても取り扱いは簡墘です。 


ホ FrontPageExpress 
MIcrosoftCorporalion 
のホームページ作成ソ 
フト。 

★ HomePageBuildef 
mM のホームページ作 
成ソフト。 


一判断として、「 FrontPageExpress 」* や I HomePageBuilderJ •のような 
アプリケーシヨンソフトを使わずに html を手書きできる人なら、 KAG を使っ 
てすぐにゲームが作れます D なぜ断定的な物言いができるかといえば、私0身 
がそうだったからです。 

もちろん、 「吉里吉 1 E / KAG 」 を用いてゲームを制作する場合、 「簡琳 作成 
ツール」などと銘打たれているソフトを使うより勉強董は增えます。でも、万 
能無敵な演出効果と美しい画像処理、そして開発者が涙するほどのきめ細や 
かなチューニング&カスタマイズ機能を目の当たりにすれば、あなたは絶対に 
「吉里吉里/ KAGJ を手放したくなくなるでしょう。 

私自身、最初は基本的なコマンド • タグ（命令）のみを使ってゲームの骨 
組みを構築していました。初めて作ったものは、画面切り替えも変数処理も 
ない、ただ読ませるだけの絵本でした。 
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CM 「吉里吉里/ KAG 」 とは? 

_###### 


ですが、開発を進めていくにつれて演出に対する希望や要求が増えてきたの 
で、その場その場で実現したい演出に必要なコマンドを少しずつ勉強してきた 
のです。そして「吉里吉里/ KAG 」 は、見事にその要求に応えてくれました。 

つまり、最初にすべてを覚えるのではなく、自分に必要なコマンドを自分の 
ペースで段階的に学んでいけるのが、「吉里吉里/ KAG 」 の意外なゥリでもあ 
り、開発者に対する優しさなのです。 

このように、「吉里吉里/ KAG 」 は、プログラムの書けないクリエイターに 
はうってつけのバランスの取れたスクリプト • ツールですが、バリバリとプロ 
グラムを書いている人にも朗報があります。 


「吉里吉里 J の上で動作する 「 KAG 」 は、前述した通り吉里吉里の専用言語 「 TJS 」 
で書かれているため、動作が気に入らなかったり、提供されていない機能を追加 
した V 、場合には、 KAG 自体を 「 TJS 」 レベルでカスタマイズすることが可能です。 

もちろん、わざわざ 「 KAG 」 をカスタマイズしなくても、オリジナルの 「TJS 
式」を 「 KAG スクリプト」内に書くことで TJS を使った演出は可能になりま 
す。背景画像の上に雪や雨など（好みによっては槍なども）を降らせたり、ク 
リッカブル.マップを使ったり、複雑な画面処理を行なったり…と、市販ゲー 
厶に実装されて t ゝるた t 、て t 、の処理は可能になります。 


KAG のカスタマ 
イズについてです 
が、 「 TJS が理解で 
きる人は KAG 自体 
も好きなように力 
スタマイズしてく 
ださい。どんどん 
しちゃってくださ 
い」と開発者の 
W . Dee さんは申し 
ております。 


r 吉里吉里/ KAGJ の嬉しい仕様 


それでもまだ疑いの目で見ているお尻の重い人に、「吉里吉里/ KAG 」 の嬉 
しい仕様をアナウンスします。でも、全部を書くとページが無くなるので、少 
尉が感心した仕様や機能の一部について、簡単に書いておくことにします。 


①対応ファイル形式が豊富 

画像は現在流通しているほとんどの形式が取り扱えます。また、 BGM とし 
ては MIDI や OggVorbis * が指定できる他、音楽 CD トラックの利用もできま 
す。ミックス CD 形式で配布すれば、プロ顔負けのパッケージングも不可能で 
はありません。また、 Flash ムービーや MPEG など、新しく登場してくる主要 
なファイル形式についてはプラグインで随時対応しているので、エンジン自体 
がいつまでも陳腐化しません。 


ホ OggVorbis 
パテント，ロイヤリテ 
ィー • フリーのため特 
許料に振り回されるこ 
とのない音声圧縮形式、 
別名 「 MP 3 キラ-^。 
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KAG を使 3 前に 



摩，，：> ジシ sr ン 
面_を切り譬えること。 
「ブラインド」 r フエー 
ド JHi 春き JT チエツ 
力など、さまざま 
辦ンジシ母ンがあ 
:蓦。: 



②トランジシ3ン • パターンを自作できる 

ビジュアル命の萌え ゲーム や雰囲気を大切にする ア ド ベンチャー.ゲームで 
は、トランジシヨン*もカッコよく行ないたいものですが、「吉里吉里/ KAG 」 
ではオリジナルのトランジシヨン. パターンを 何種類でも ゲーム 内に取り込め 
る 「ユニバーサル. トランジシヨン」と呼ばれる機能があり、 クリエイター心 
をくすぐります。また、 「 KAG 」 には、用い方によっては絶大な視覚演出効果 
を 期待できる 「スクロール* トランジシヨン」と呼ばれる機能もあります。 


③ 制限のない変数とフラグ 

「吉里吉里/ KAG 」 では、「フラグ」「数値変数」「文字変数」をほとんど 
同様のオブジェクトとして取り扱うことができます。このため、それぞれの利 
用方法を別々に学ばなくても一貫した書式で自在に活用できます。また、変 
数の最大数や演算に制限は一切ないので、変数資源の枯渴を気にせず自由に 
利用することができます。乱数生成や自由演算はもちろん、論理分岐にから 
めて変数の増減を行なうこともできるので、市販の.ァ ドベンチャー • ゲームに 
用いられている システムを 再現することも簡単です。 

④ デバッグが楽 

玄人向けのデバッガとモニタが搭載されているので、プログラム実行時にス 
クリブトがどのように解釈されているか、変数がどのように扱われているかを 
随時確認することができます。特に変数については、プログラム実行中に恣意 
的に任意の値を代入することが可能なので、変数分岐処理の確認やデバッグ 
に活用できます。慣れるまでは少し掛かるかもしれませんが、手に馴染みます。 


⑥ EXE 形式で配布可能 

完成したゲームは EXE 形式にリンク（結合）して配布できます。ランタイ 
厶もプレイヤーソフトも一切不要なので、ユーザーに「何だよ。これだけじ ゃ 
動かないのかよ！ だっせ一！」と失望感を味わわせることも少なく、何より 
ファイル1個でゲームが動 t 、てし まうのが、市販ソフトみた t 、でカ ッコ いいで 
はありませんか。 















0-2 KAG のプロジェクト • フォルダについて 




為 G ❿プ Q ジ怎クト•フオルダ貧 

、、… 


「吉里吉里」のアーカイブ • ファイルには、「吉 
里吉里本体」の他に、吉里吉里をサウンドノベル 
やアドベンチャー.ゲームのエンジンとして動作 
させるための 「 KAG システム」（以後 「 KAG 」 と 
表記）が含まれています。 

KAG は右のようなフォルダ構造から成り立って 
いますが、このうち KAG の“本体”と呼べる部分は 
「 template 」 フォルダ以下の10個のフォルダです。 

これらは、ゲームに必要な素材を入れておくた 
めのフォルダ群であり、これら10個のフォルダを 
全部まとめて 「 KAG のプロジェクト.フォルダ」 
と呼びます。 


由 ，.I 

白 J 


白 Q kr 2.218 r2 
B kag3 

S-Q kag3doc 
S-Q kag3plugin 
-1 .\ savedata 
1 Q syoukai 

ぬ PSB 

Q be image 
Q bgm 
U fgimage 
Q iniage 
Q others 
Q rule 
■Q scenario 
■Q sound 
Q system 
G3 video 
fi]-Q kirikiri2 


デフォルトではプロジェクト • フォルダは 「 tem ¬ 
plate 」 という名前になっていますが、これはゲームのタイトルなどに自由に変 
更してかまいません。念のために別の場所に新しいフォルダを作り 、 template 
以下のサブフォルダをコピーして、そちらを開発に利用するとよいでしょう。 

template 以下のサブフォルダには、以下のような素材ファイルを入れます。 

• 画像を入れるフォルダ 


bgimage 

背景絵 

fgimage 

キャラクターの立ち絵など、前景に表示する絵 

image 

イベント絵に代表される一枚絵など 

rule 

トランジシヨン用グレースケール画像ファイル 


音声や動画を入れるフォルダ 


bgm 

MIDI. OggVorbis 形式の BGM 

sound 

Wave、OggVorbis 形式の効果音 

video 

AVU MEPG、SWF 形式の動画 


poenano : j L のシナリオ子キストファィル 


_⑩_馨參_ _ 

___園 


■ .■バし 


r 吉里吉里」も 
「 KAG 」 も 、 「LZHJ 
と呼ばれる圧縮形 
式で配布されてい 
ますが、これはそ 
のままダブル•ク 
リックしても実行 
できません。まず 
は LZH ファイルを 
展開し、中身を取 
り出す必要があり 
ます。 

展開するには専 
用のアーカイバと 
呼ばれるソフトウ 
エアが必要ですが、 
これらはインター 
ネットのフリーソ 
フト紹介ページで 
無料ダウンロード 
できたり、雑誌の 
付録の CD - ROM な 
どに収録されてい 
るので、まずはそ 
れを手に入れまし 
よ 

なお、圧縮ファ 
イルの取り扱いに 
ついては本書では 
特に説明しません 
ので、圧縮解凍の 
方法がわからない 
方はインターネッ 
卜や雑誌の付録 CD 
などで別途学習し 
てください。 
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KAG を使う前に 



_ 


_ #翁翁 




ゲームを開発し 
ている最中はプロ 
ジェクトの動作確 
認を行なう回数が 
非常に多くなるた 
め、最初からシヨ 
一トカットを作つ 
ておくと便利です。 

① krkr . eXe のシヨ 
ートカットを作成 
します。 

② この シヨー トカ 
ットの「プロパテ 
ィ」を開くと、[シ 
ヨートカット]タブ 
内にリンク先とい 
う項目があります。 
この末尾に半角ス 
ベースを空けてか 
ら、プロジェクト 
フォルダのフォル 
ダ名を、""で囲ん 
で害きます。 

以降は、このシヨ 
一トカットをダブ 
ルクリックするだ 
けで指定されたブ 
ロジェクトが吉里 
吉里で動作します。 

プロジェクト* 
フォルダが吉里吉 
里の実行可能ファ 
イルと速う場所に 
ある場合はブロジ 
ェクト•フォルダ 
名をフルバスで指 
定してください。 

さらにこのシヨ 
一トカットをスタ 
一卜* メニューに 
登録しておけば、 
デスクトツプ上の 
アイコンをダブ 
ル•クリックしな 
くてもキーボード 
の Windows キーで 
すぐに起動できて、 
非常に便利です。 


• システム関係のフォルダ（追加や削除は不可) 
KAG の設走テァイル 


• その他のフオルダ 
[others その他のファイル 


この中でも開発中に頻繁にアクセスすることになるのが 「 scena rio 」 フォル 
ダです。 

scenario フォルダには、画面に表示する文章と各種の制御を行なうタグが書 
き込まれる 「 ks 」 という拡張子のファイルを置きますが、 KAG でゲームを制 
作するという行為は「このフォルダ内のシナリオ • ファイルを書く」という行 
為そのものに当たります。 

つまり、 KAG でゲームを作る場合は、素材を準備して各フォルダに配置し、 
後はそれらを制御するためのシナリオ • ファイルを書くという手順で行なうわ 
けです。 


■開発環境を整える 


プロジヱクト • フォルダである template フォルダは、そのままでは実行でき 
ません。 実行するには吉里吉里本体である 「 krkr . eXe 」 が必要になります。実 
行方法ですが、二通りあります。 


① template フオルダを 「 krkr . eXe 」 のアイコン上にドロップする 

② 「 krkr . eXe 」 を起動して、実行プロジヱクトに template フォルダを指定する 

ここで間違えやすいのは、フォルダ/アーカイブの選択時に 「 startup . tjs 」 や 
「 first . ks 、 scenario 」 フォルダなどを指定しまうことです。これらのファイルや 
サブフォルダを指定してもエラーが返るだけなので、必ず template フォルダそ 
のものを指定（またはドロ V プ）する必要があります。 
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KAG のプロジェクト • フオルダについて 




rkrkr . eXeJ は開発の都合上、プロジヱクト.フォルダと同じ階層に置かれ 
ていると便利なので、まずは kirikiri 2 フォルダ内に置かれている 「 krkneXe 」 
を template フォルダ（名前を変えて、別に作っている場合はそのプロジェク 
卜•フォルダ）と同じ階層にコピーしておきましよう。 

動作が確認できたら、いよいよ開発を始めますが、その前に、 template フ 
ォルダ内の sysytem フォルダの中にある 「 Config .~ new 」 という名前のフアイ 
ルを 「 Config . tjs 」 に改名しておきます。これをせずにプロジェクト • フォル 
ダを 「 krkr . eXe 」 で実行しようとすると、エラーになります。 



プ□ジヱクト名のついたフォルダ 
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KAG を使う前に 


# 


0-3 


Conffg.tjs を調整する 


r r r マ 

r r r- ^ 
— - ，ン_ 



WindowsMe にお 
けるファイルとア 
ブリケーションの 
関連付けは以下の 
ように行ないます a 

まず、マイコン 
ビュータを開き、 
「ツール」メニユー 
から「フォルダオ 
ブション」を選び、 
「ファイルの種類 J 
タブをクリック。 
さらに「新規」を 
クリックし、拡張 
子の部分に” s と入 
力して 「 OKJ をク 
リ ック - 

これで tjs 拡强子 
が發録されたので、 
こんどはそれをリ 
ストから探してク 
リックし、右下の 
「詳細投定」をクリ 
ツク 

「新規」をクリ 
ックし、アクシヨ 
ンに ropenj と入 
力後 、 r 參照」をク 
リックして自分が 
よく使うテキス 
卜 • エディタの実 
行ファイルを指定 
したら、ひたすら 
I 0 KJ をクリック 
してダイアログを 
閉じれば、設定終 
了です。 

私はフリーのエ 
デイタ 「TeraPadJ 
を爱用しています 
が、この場合は 
「アクションを実行 
するァブリケーシ 
ョン」の部分に 
「 TeraPad . exe 」 を 
指定した後、半角 
のスペースを空け 
てから"％ 1" と記述 
する必要がありま 
す。 TeraPad を使 
う人は注意してく 
ださい。 


ソフトの定義ファイルなど普通の人は見ませんが、 “ KAG 使い”を目指すな 
ら、何が何でも 「 Config . tjs 」 を理解する必要があります。 

ちなみに、ダウンロードしたばかりの template フォルダには 「 Config . tjs 」 と 
いうファイルは存在せず、代わりに rConfigrnewJ というファイルがあるの 
で、まずはこれを 「 Config . tjs 」 にリネームします。 

「 Config . tjs 」 はそのままではダブル-クリックしても開けないので、拡張 
子が rtjsj のファイル形式を皆さんがよく使うテキスト•エディタに関連付け 
ておくとよいでしょう。 

「 Config . tjs 」 は、 「 KAG 全体の設定」「ウインドウや動作の設定」「メニュ 
一の設定」「メッセージ.レイヤーの設定」 「 BGM の設定」「メッセージ履歴 
表示の設定」——の6つのエリアに分かれていますが、ここでは順を追って変 
更が必要な埸所を解説していきます。 

•全体の股定 

// ♦ タイトル 

// ウィンドウのキャプション（タイトル）および 
//タスクバーに表示されるものです。 

； System . title = ••吉里吉里”；_ — — _ _ — 

t 「吉里吉里」という文字をゲームのタイトルに直す。 


// ♦ シナリオ解析モード 

//シナリオファイル中の改行に従わせたい場合に false を設定します。 
// false を指定すると、 KAG のシナリオ中の改行が、行末に¥または 
// [ p ] を書かない限りそのままメッセージレイヤ上での改行として扱われ 
//ます。 true を設定すると [ r ] タグを書かない限り改行されません。 
II KAG 2. X 互換にするには false を指定してください。 

_； global•lanoreCR = true ； _ 

t 本書の解説通りに演習したいのなら、 「 false 」。 
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0-3 Config.tjs を調整する 


轉: 撕 'ゾ . - 十，’ i . 斗.•八 

•ウィンドウや動作の設定 


t 変更するとトラブルの元になります。 


// ♦ 読みとり専用モード 

// readOnlyMode = true とすると、ディスクへのいっさいの書き込み 
//動作をしなくなります。 CD - ROM 上から実行させるときなどに指定して 
II ください。もちろん、その場合は桨の保存などができなくなります。 

； readOnlyMode = false ； 


t CD で配布し、セーブさせないデモ版などは 「 true 」 に。 


同人即売会など 
で CD に焼き込んだ 
作品を販売する人 
遑は、特にセー 
ブ • データの取り 
扱いについては注 
意してくださいね。 

インストーラを 
使ってインストー 
ルさせるか、セー 
ブ • データを保存 
させない指定にし 
たほうがトラブル 
が減ります。 


t 通常は 「 false 」 のままでよい 0 
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function KAGWindow 一 config() 

{ 

// ♦ 画面サイズ 

/ / scWidth に画面の幅、 scHeight に画面の居！さをピクセル単位で指 
//定します。標準的に使われている 640 x 480 や 800 x 600 のような画 
//面サイズではないサイズに設定すると、フルスクリーンにできない場合 
//があります。 

； scWidth = 640; 

; scHeight = 480;_ 


// ♦ フリーセーブ 

//罙の保存形式を指定します。 

// false を指定すると、メニューバーの「菜をたどる」「杲をはさむ」の 
//サブメニュー項目からセーブデータを保存したり読み込んだりします。 
//この場合は保存可能な呆の最大の個数は nuroBookMarks によって制 
//限されます。 

// true を指定するとフリーセーブモードになり、「罙をたどる J では 
// 「開く」ダイアログボックス、「菜をはさむ」では「名前を付けて保存」 
//ダイアログボックスが開き、桨を個別のファイルとして保存するモード 
//になります。この場合は保存可能な菜の個数に制限はありません。ま 
II す:、 エクスプローラなどによる采の管理が容易になります。 

； rreeSaveDataMode = false ; 


画ムぅ半作もし 
な I ど途制てり 
変ゲ '中でつた 
にのがなズとつ 
~ズすんィかだ 
まィまあサの_ 
たサ見てなる思。 
面をし端す不て 










// ♦サムネイルを保存するか 

// false を指定すると、セーブデータの拡張子は .kdt になり、サ厶ネ 
//イルは保存されません。 

// true を指定すると、セーブデータの拡張子は .bmp になり、 エ クスプ 
// 口ーラや「開く」ダイアログボックスの「縮小版」表示でセーブ時点で 
//のサムネイルを表示することができるようになります。 

; saveThumbna 1 1= false ; 
t 通常は 「 false 」 のままでよい。 

// ♦ セーブデータ保存場所 

// ； saveDataLocation = " savedata " ； 

//のように指定すると、吉里吉里の実行可能ファイルと同じフォルダ以下 
// の savedata フォルダにデータが保存されます。 

// ; saveDataLocation = System.personalPath + "吉里吉里の 
// 菜データ" ;; saveDataLocation = System.appDataPath + "告 
//里吉里の菜データ"；のように指定すると、ユーザーごとのホームディ 
//レクトリ以下の”吉里吉里の罙データ"というフォルダのしたにデー 
//夕が保存されます。この場合は、例で示した"吉里吉里の杲データ" 

//の部分は他のゲームなどと重ならない、十分にユニークな名前である必 
// 要があります。 System.personalPath の場合は通常「マイドキユ 
// メント」フォルダ、 System . appDataPath の場合は Application 
// Data になります。また、フリーセーブモードであってもシステム変数 
//やシステムの設定を記録するためにこのセーブデータ保存場所の指定は 
//必須です。詳しくは KAG3 ドキュメントの「セーブデータに関して」を 
//参照してください。 

； saveDataLocation = " savedata " ;_ 

t 作品の略語にすると吉里吉里で制作されたゲーム同士で重複しないため、変 
更すべき。 







// ♦ 文字表示スピード（ミリ秒/文字） 

； chSpeeds.fast =10; // 「高速」文字表示スピード 
； chSpeeds . normal = 30; // 「普通」文字表示スピード 

； chSpeeds.slow = 50; // 「遅い」文字表示スピード _| 

t 通常はこのままでよい。が、速くするとユーザーが喜ぶ。 

// ♦ 通過記録の最大数 

//通過記録の最大数を指定し ます。 最大、 ここで 指定した回数、前に戻 
//る事が できます。 大きく すると セーブデータ も 大きくな ります。 
；maxHistoryOfStore =5; 

t 一つ上の「前に屄る」機能を使わない場合は〖0」でよい。 

// ♦ 利用可能な効果音バッファの数 

//利用 可能な効果音バッファの最大値を指定し ます。 つまり、 ここで 指定 
//した数の分だけ効果音を同時に再生で きます。 効果音を使用し ない 場合 
//は0を指定して かまいません。 

；numSEBuffers = 3; 

t 通常はこのままでよいが、効果音を同時に2つ以上発音しなければ「1」で 
も足りる 0 


03 Config.tjs を調整する 


m m m 


// ♦ データ 名プレフィクス 

// ここで指定した名前で始まる名前で罙関連のファイルが作成されます。 
//フリーセーブモードの場合でもシステム変数やシステムの設定を保存する 
//ファイルに影響します0 

_ ； dataName _= _ n data" ; _ _ 

t ここも作品の略語にする。 

(例： 「1999 ChristraasEve 」 の場合は 「1999 xe 」） 


画 _ i _ ■画_圓^^^ 


議議隱 


ァ，'ヤ小て節べもま 
フ j イ最しのスでり 
ツヤレ要義リ低ンな 
バイジ必定モ、シに 
音レーはをメりマう 
果蚤セど数となのよ 
効前ツなのくにクく。 

やメー 限お約ツ動す 


前上ィ態義に ntl 使らま音てしのだ 
、[0レ状定要叫'滅い果いでい く 
は J •のに必|しらて効つ内なて 
合~(ジ~ 1 恥、|>たし、に tjs きし 
場ヤ lrlig. き 6[ 增っにしァ ig. で意 
のィセは onf おたでわぅだフ 3nf 義注 
私レッ ICC てっグ終よ。たッ CO 定、 
景メヤでしな夕いすすパはかで 
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KAG を使う前に 



// ♦ 初期状態の前景レイヤの数 
//必要なければ〇を指定してかまいません。 

//数が多いと速度が低下したりメモリを消費しますので、必要以上に大き 
//な数を指定しない方が良いでしょう。 

// laycount タグでシナリオ内でも変更できます。 I 

— ;numCharacterLayers = 3 r 

t 通常はこのままでよいが、前景を使わなければ「0」にしたほうがよい。 — 
// ♦ 初期状態のメッセージレイヤ6数 

//前景レイヤと違って、0を指定することはできません。これも必要な数 
//だけ確保するようにすべきです。 laycount タグでシナリオ内でも変更 
//できます。 

; numMessageLayers =_2 ； _ 

t 通常はこのままでよいが、普通に文字を表示するだけなら「1」でもよい。 

// ♦ 利用可能な罙の数 

// メニューに表示し、ユーザーが選択可能な架の数です。 

// save や load タグで保存可能な呆の数はこの設定には影響しません。 
II メニューによる呆の管理を行なわない場合 （ ゲーム画面中で全部架の 
//管理などを行なう場合など）は、 numBookMarks は必要な数に設定 
// し、 restoreMenu.visible と storeMenu.visible を false に 
//設定してください。 

一 ; numBookMarks =—10; _ 

t 作品内容に合わせて適宜変更。そこそこ多くするとユーザーは喜ぶかも。 

// ♦ 「ヘルプ > 目次」を選択したときに実行するファイル 

//ここで指定するファイルは吉里吉里実行可能ファイルと同じ場所に設置 

//されていなければなりません。 

；helpFile = " readme.txt" ; 
t ヘルプ • ファイルの名前を拡張子まで含めて指定する。 
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// ♦ 「文字表示 > アンチエイリアス」 

_ ス chAntialiasMenuItem.visible = true; 
t 通常はこのままでよい。 


// ♦ 「文字表示 > フォント」 

—; chChancyeFontMenuItem. visible = true; 
t ユーザーに フォントを変更させたくなければ、 「 false 」 に。 


// ♦ 「ヘルプ」 

； helpMenu.visible = true; 


0-3 Config.tjs を調整する 

_ _ #參馨參# 


籲メニューの設定 


// ♦ 「システム > 前に戻る」 
； aoBackMenuItem.visible = true; 


T 作品内容に合わせて変更する。前に戻らせたくなければ 、 I false 」 に。 


一 


t 通常はこのままでよい。ヘルプが無ければ 「 false 」 に。 


// ♦ 「デバッグ」 

； debucrMenu .visible 


raise ； 


t 開発中は 「 true 」 に。リリースしたら 「 false 」 に。 


•メッセージ • レイヤーの設定 


runction MessageLayer_config() 

{ 

// ♦メッセージ枠用の画像 

// メッセージ枠用の画像のファイル名を指定します。 

//"” を指定するとメッセージ枠の画像を使用しません。また、メッセ 
// -ジ枠用の画像を指定した場合、 position タグでメッセージレイヤ 
//のサイズを変更するとおかしな表示になると思います 
; frameGraphic = "" ; // position タグの frame 属性に相当 


メッセージ . レイヤーに枠をつけたい場合は、ファイル名を指定。 


いつも思うんで 
すが、どうして 
KAG の「デバッ 
グ•モード」はデ 
フオノレトが「 false 」 
なんでしようね。 


メ ツセー ジ枠を 
使ったサンプルが 
CD に収録されてい 
るので、ご#考に 
どうぞ。 


リ字ャなとア場がい得さ逆のだ 
ィ文ジたこリたズしを小はるく 
エ、{立のィしィ美ン，合なて 
チはザ目能 H にサばィが場くし 
ンとギを機チ N 字れラすのく意 
ア J ザ}る。ン〇文け卜ま字に注。 
r スギ|すすアを、きゥれ文見、い 
アのギくでス合大アらいにでさ 
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// ♦ 初期位置 

//これらは、 position タクのそれぞれ left top width height の 
// 属性に対応します。 

； ml =16; //左端位置 

；mt =16; //上端位置 

；mw = 640-32; //幅 

;mh = 480-32； // 咼さ _ 

t この状態はノベル風の画面。アドベンチャー.ゲーム風にしたければ、 
「 mt =400 mh =60」 などに変更する。 


// ♦ 文字の大きさ 

//デフォルトの文字の大きさ（高さ）を pixel 単位で指定します。 
_ ； defaultFontSize = 24; // deffont タグの size 属性に相当 

t 作品内容に合わせて変更する。 


// ♦行間 

//行間を pixel 単位で指定します。 

；defaultLineSpacing = 6; // defstyle タグの linespacing 

属性に相当 ___ 

t 作品内容に合わせて変更する。 



KAG を使う前に 






〆 ，卜 ; H 


職 

卜,::::::. 

11*11 

iilis 


// ♦ メッセージレイヤの色と不透明度 

// frameColor には OxRRGGBB 形式で （RR GG BB はそれぞれ2 
II 桁の16進数）メッセージレイヤの色を指定します 。 frameOpacity 
II には〇〜 2 H の数値で、不透明度を指定します。メッセージ枠用の 
//画像が指定されている場合は無効です。 

; frameColor = 0 x 000000; // position タグの color 属性に相当 
; frameOpacity =128; // position タグの opacity 属性に相当 


t 作品内容に合わせて色と不透明度を調整。 



一に収ン思 
ャ面にサと 
チ画 R るだ 
ンの C い効 
ベ風して有， 
、ムてれが to 
ア I いさルま 
ゲつ録ブい 





: 'V ぐ'ハ'.':'，... ■:• .ベ 
、、、.•>ネベ、"、に/ V レぐ、厂 >>」 心 
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0-3 Config . tjs を調整する 




// ♦字間 

//字間を pixel 単位で指定します。 

//デフォルトは0で、正あるいは負のオフセットで指定します。 

//負の数値を指定すると字間が詰まります。正の数値を指定すると時間が 
//空きます。 

；defaultPitch = 0; // defstyle タクの pitch fete にィ日当 _ 

t 作品内容に合わせて変更する。 


// ♦ 文字の書体 

//デフォルトのフォント名を指定します。 

//この設定はシステム変数に記録されて、次回起動時に引き継がれるの 
//で、 userFace の設定を変更し、適用したい場合はシステム変数ファ 
//イル ？？？？？ sc . kdt の " chdefaultFace " =>の行を削除してくだ 
//さい。カンマで区切って複数のフォントを指定することができます。そ 
//の場合は、最初の方に書いたフォントが存在すれば、優先されます。 

； userFace = " MS _P 明朝"；// def font タフの face fe ’ fc に相当 
t Windows 標準のフォントを使うことが原則。 


// ♦ 文字の色 

//デフォルトの文字の色を OxRRGGBB 形式で指定します。 
；defaultChColor = Oxffffff ; // def font タグの color 属性に 

相当 _ 

t 作品内容に合わせて変更する。 


// ♦ 文字をボールドにするか 

//する場合は true , しない場合は false を指定します。 
；defaultBold = true ； // def font タグの bold 属性に相当 
t 作品内容に合わせて変更する。 


// ♦ ルビサイズ 

//ルビサイズを pixel 単位で指定します。 

—； defaultRubySize =10; _//_ def font ヌフの rubysize こネ目与 
t 作品内容に合わせて変更する。 


鬱參⑩_鎌#參 


文字の害体につ 
いてですが、自分 
が持っているフォ 
ントを指定しても、 
ユーザーの 中には持 
っていない人がい 
るかもしれません。 
普及率の少ないフ 
ォントならなおさ 
らです。できるだ 
け Windows 標準の 
フォントを使うか、 
自分で作ったオリ 
ジナルのレンダリ 
ング•フォントを 
利用するようにし 
てください。 
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KAG« 使う 前に 

v :，撕輕（'ザ そ vv ごシ ' ぶ、..り？へ , ; .v4 佐な r ぺ r ^y ： ^-^p%^t f ： ハて:ぐ .子' び;、ゆ. •£■>、？：., し-•、-紐を じ : 



// ♦ ルビの表示オフセット 

//負の数を指定するとその pixel 数分、本文に近い位置に表示されます。 
;defaultRubyOffset = -2; // def font タグの rubyof fset に相当 
t 作品内容に合わせて変更する。 " 


// ♦ アンチエイリアス 文字描画をする か 
//する場合は true , しない場合は false を指定します。 
；defaultAntialiased = true ; 
t 作品内容に合わせて変更する。 


// ♦ 影の色 

//影の色を OxRRGGBB 形式で指定します。 

；defaultShadowColor = 0 x 000000； // def font タクの shad ¬ 
owed or に属性に相当 _ 

t 作品内容に合わせて変更する。 


// ♦ 縁取りの色 

//縁取りの色を OxRRGGBB 形式で指定します。 

; def aultEdgeColor = 0 x 0 00000； // def font タクの edgecol - 

or に属性に相当 ^ _ 

t 作品内容に合わせて変更する。 


// ♦ 影を描画するか 

//する場合は true , しない場合は false を指定します。 

; default Shadow = true ; // def font タグの shadow 属性に相当 

t 作品内容に合わせて変更する。 


// ♦ 縁取りをするか 

//する場合は true , しない場合は false を指定します。 KAG 3 から、 
//縁取りと影を同時に描画することができなくなりました。縁取りを指定 
//した場合は縁取りが優先されます。 

— ；defaultEdae _=_ false ; —II def font タグの edcre Jfe 性に相当 
t 作品内容に合わせて変更する。 










議麵 _ 圓圖 _ 圖遲圍__議_圖議 __ 圖議圓麵園 * 11111111 ® 111818 


0-3 


Config.tjs を調整する 




// ♦ リンクの強調色 

//リンクを選択したときに出る半透明矩形のデフオルトの色です。 

； defaultLinkColor 二— 0 x 0080 ff ; // link タクの color 属性に相占 

t 作品内容に合わせて変更する。 

//善飞 I ンクの不透明度 ] 

//リンクを選択したときに出る半透明矩形の不透明度です。 

— ； defaultLinkOpacity _= 64; _ _ 

t 作品内容に合わせて変更する。 

// ♦ 縦書きモード 

// メッセージレイヤを標準で縦書きモードにする場合は false ではなく 
// true を指定してください。 

'• vertical = false ； // position タグの vertical 属性に相当 
t このままだと横書き。縦書きにしたければ 「true」 に。 

• BGM の設定 

function BGM_config() 

{ 

// BGM の設定です。 

// CD - DA , Wave , MIDI のいずれかを BGM として再生することができます。 
// ♦ BGM 再生メディア 

// type 変数に設定する文字列で、使用するサウンドバッファを決めるこ 
//とができます。 

// 11 Wave n : WaveSoundBuffer { wav 等（プラグインで再生できる 

物も含む）） 

// " MIDI " : MIDISoundBuffer ( mid,smf ) 

// "CDDA，， : CDDASoundBuffer ( cda ) 

— ；type = M MIDI ";_ 

t このままだと [playbgm] で再生できるファイルは 「.mid」 になる。 rOggVor- 
bisj を BGM に鳴らしたければ、 「MIDI」 を 「Wave」 に変更する。 
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t 音楽 CD を制御する場合は、その CD のボリューム • ラベルを書く。 

•メッセージ履歴の設定 


t 作品内容に合わせて変更する。 


t 作品内容に合わせて変更する。 


T 作品内容に合わせて変更する。 


t 作品内容に合わせて変更する。 


t 作品内容に合わせて変更する。 











// ♦フォントを太字にするか 
；fontBold = true ; 


// ♦ フォント名 
； fontName = "MS P 明朝”; 


// ♦ フォントのサイズ （ pixel 単位) 
； fontHeight = 24; 


// ♦ ラインの高さ 
— ; lineHeicrht =_26 ; 


// ♦ 縦書きの場合は true 
； verticalView = false ； 


// ♦ CDDA 再生ボリュームラベル — — 

// " CDDA " を指定した場合は、 cdVolume 変数に、再生する CD のボ 
//リュームラベルを指定します。ボリュームシリアル番号ではありません。 
// KAG は、このボリュー厶ラベルを持った CD の挿入された CD - ROM ド 
//ライブで CD - DA を再生します。特にマシンに複数の CD - ROM ドライブ 
//が装着されている場合にこれを元にしてドライブの区別を行ないます。 

; cdVolume = " xxxx " ； 
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0-3 COhfig.tjs を する 



// ♦ ページ単位での閲簧を行なうかどうか 
//ページ単位での閲覧をするようになると 

// cm ct er タグ、あるいは repage 属性が true の hr タグ 
//でメッセージ履歴の改ページを行なうようになります。 
；everypage = false ; 
t 作品内容に合わせて変更する。 


// ♦ 自動改行を行なうかどうか 
;autoReturn = true ; 
t 作品内容に合わせて変更する。 
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KAG を使う前に 



0-4 


rKAGj t r タグ j と mm ；:| 



「 KAG 」 は、「タグ」と呼ばれる命令を上から順番に並べていくだけで「吉 
里吉里」をゲーム•エンジンとして動作させるものです。このため、まずはこ 
れらのタグを理解することが先決です。 

タグの並べ方によっては高度な表現や演出が可能になりますし、逆に、思 
った通りに動作しないほとんどの理由はタグの書き間違いから生じるものです。 
このため、 「 KAG を使いこなす」ということは、 「 KAG に準備されているタグ 
使いこなす」ということになります。 

タグは以下のように書きます。 

•記述例 

ter ] 

Limage storage= H test . bmp " layer=base page = fore ] 


上のタグも、下のタグも、 KAG のタグです。上のタグは短くて覚えやすい 
ですが、下のタグは t 、ろいろ書 t 、てあってややこしそうです。 


このように KAG には、「タグのみで使えるタグ」（上の例では 「 er 」） と、 
「“属性”と呼ばれるパラメータを併記する必要があるタグ」（上の例では 
「 image 」） の2種類があります。 

「タグのみで動作するタグ」は、□で挟んでそのまま書くだけですが、「属 
性をもつタグ」の場合は、以下のような書式に則って記述する必要があります。 


•記述例 

[タグ名（半角スペース）属性名=(半角イコール）属性のパラメータ] 

属性が複数存在する場合のタグは、さらに半角スペースを空けて「属性名」 
と「属性のパラメータ」を半角イコールで結んだものを記述します。 

なかには属性が10個近く並ぶような複雑怪奇なタグもありますが、最初は 
そんなものは無視してかまいません。 

少しずつ自分のペースに合わせて利用できるタグを増やして t ゝけるのも KAG 
の魅力です。 















0-4 「 KAGJ と「タク J と「属性』 

.づ二….も:;'.'み111111 ________ _____ 




タグの書き方と2種類のモード 


実は KAG には2種類のタグの書き方があります。ひとつは 「 KAG 2」 までの 
書き方、もうひとつは 「 KAG 3」 から利用可能になった書き方です。例を見て 
みましよう。 

•「 KAG 2 互換モード」によるタグの書き方 

[image storage =" sample . bmp " layer=base page = rore ]¥ 


•「 KAG 3 モード」によるタグの書き方 

©image storage =" sample . bmp " layer 二 base page=fore 


上の 2 つのタグは同じ意味です。どちらでも使 t ゝやすい方を使えば t ゝいので 
すが、私は古参の KAG ユーザーであることを除いても KAG 2 互換モードのほ 
うが使 t ゝやす t ゝと思っているのですが、それはタグ行の改行処理の違 t ゝに理由 
があります。 

「 KAG 2 互換モード」では、タグ行の末尾に半角の「¥」を記述することで、 
その行を非改行にすることができます。これは言い方を変えると、「その行を、 
画面上では存在しない行として扱うことができる」ということになります。 

たとえば、サウンドノベルの画面のように、文章が主体でその中にタグ行を 
記述した場合、 「 KAG 2 互換モード」では行末に半角の「¥」を置くか置かな 
いかで、その行自体を一行の空白に当てるか、それとも存在しない行として扱 
うのかが決められます。 

これは練習文です。 

[playbgm storage =" bgm • mid "] ¥ 

さらに練習文が続きます。 


上のようなシナリオを書くと、以下のように画面表示されます。 
これは練習文です。 

さらに練習文が続きます。 

では、「¥」を外してみるとセうなるでしょうか。 一一 





吉里吉里/ KAG 開 
発者の W . Dee 氏の 
話では、古くから 
の KAG ユーザーは [ 
] で挟む KAG 2 互換 
モードを、最近の 
ユーザーは KAG 3 
モードを好んで利 
用する傾向にある 
そうです。 

タグ行に記述す 
る記号はすべて半 
角です。アルファ 
ベットはもちろん、 
[] や¥などもすベ 
て半角で害かない 
と動作しません。 









KAG を使う前に 






私の処女作品す 
ある19990 hristmas- 
Eve がリリース中断 
して作り直しにな 
つた直接原因が吉 
里吉里/ KAG の存在 
でした。 

ですので、私が 
吉里吉里/ KAG に出 
会ったのは1999年 
の12月頃になりま 
すね。 


これは練習文です。 

[playbgm storage ^" bgm . mid "] 
さらに練習文が続きます。 


上のようなシナリオの場合は、以下のように画面表示されます。 
これは練習文で〒; 

さらに練習文が続きます。 


同じことを IKAG 3」 モードで行なおうとした場合は、次のようになります。 
これは練習文です0 _^ 

©playbgm storage =" ogm . mid " 

さらに練習文が続きます。_ 


上のようなシナリオを書くと、以下のように画面表示されます。 
これは練習文です。 

さらに練習文が続きます。 


では、間に一行挿入する場合はどうしたらよいのでしょうか。 
これは練習文です。 

@playbgm storage =" bgm . mid " 

@r 

さらに練習文が続きます。 _ 


上の例のように [ r ] タグを用いて強制的に空行を挿入しなければいけません。 


「 KAG 2 モード」と 「 KAG 3 モード」を比較してみればわかりますが、行末 
でタグが閉じて t ゝることを視覚的に理解できる方が html に似て t ゝて馴染みやす 
いという理由もあるので、私は個人的に KAG 2 モードの方が好きです。 

このような理由と、私自身が古くからの KAG ユーザーであることから、こ 
の本では 「 KAG 2 互換モード」で説明させていただくことにします。 












0-4 「KAGJ と「タグ」と 

爾鑾 ^^« 騰讎發麗 ^^^^^^^^^^ Mmmmm 


前項で説明した、 「 template 」 フオルダ内の 「 system 」 フオルダの中にある 
「 Config . tjs 」 ファイルを変更すれば、 「 KAG 3 モード」から 「 KAG 2 互換モー 
ド」になります。 

この 「 Config 加」は KAG の動作を定義するための非常に重要なファイルで 
すが、開発者の W . Dee 氏の詳しいコメントが一緒に書かれているので 、 KAG 
を動かそうとする人はぜひ読んでみてください。 
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KAG の基本操作 






KAG では、文字を表示させるために必要なタグはありません。書いた文字 
は、それだけで画面に表示されるようになります。 


fscenarioJ フォルダの中にある 「 firstks 」 というファイルを開いてみると、 
以下のようになっています。 

•シナリオ例 

[wait time =200] 

★start | スタート 
[ cm ] 

こんにちは。 


上の例の「こんにちは」の部分が画面に表示される文字です。文字はシナ 
リオ • ファイル内に書いていけばそのまま表示されますが、そのままだといろ 
いろと具合が悪いので、以下のタグを用います。 


调 

改行待ち記号を表示し、クリックまたはエンター • キーの入力を待つ。 

m 

改ページ待ち記号を表示し、クリックまたはエンター • キーの入力を待つ。 

M 

強制的に改行する。 


•シナリオ例 


これを読んだら一旦停止。 [1] 

これも読んだら一旦停止。 [1] 

ここで強制的に改行 [ r ] してみます。 [1] 
更に改行 [ r ] してみます。 [1] 

このページはここでおしまい。 [ p ] 


基本的に、各行の行末には[1]*タグを用いて、次の行を表示させる前にいっ 
たん停止させます。次のクリックでページが切り替わる表現をしたい場合に 
は、最後の行末に [ p ] タグを使います。 

[1】タグも [ P ] タグも機能はほぼ同じで、画面に表示されるマークが違うだけ 
です。これらは自由にカスタマイズできます。 

ここで注意ですが、 [ p ] タグは改ページ処理そのものを行なうわけではあり 
ません。そもそも KAG には「ページ」という概念がないので、画面をクリア 


1-1K AG の基本操作 


KAG 


_______ 

して次のページとして新たに文字を表示するためには、下記のタグのいずれか 
を使います。 

fer ! |現在の操作対象メッセ-ジ•レイヤ-をクリアし、文字属性をリ セットする。 

[ cml すべてのメッセージ • レイヤーをクリアし、文字属性をリセットす^_ 

|^_すベてのメッセージ • レイヤーをクリアし、文字属性をリセットした上に、操作 
___ 対象レイヤーを messageO に戻す。 _ _ 

画面に表示されている文字を消すタグがなぜ3種類も用意されているのかと 
いえば、これは KAG が扱えるメッセージ.レイヤーの特性が理由になっています。 

画面上に表示する文字は「メッセージ.レイヤー」と呼ばれる透明なセルの 
ようなものの上に書かれますが、これは必要に応じて増やしたり減らしたりで 
きます。 

普通のサウンドノベルや電子小説を制作する場合は、デフォルトで指定され 
ている1枚で足りますが、少し凝ったことをしたいと思うと、1枚では足りな 
くなることがあります。このような環境下で文字を消す場合に、 [ cm ] や [ ct ] を 
使う必要が出てくるわけです。ただし、メッセージ•レイヤーを1枚しか使っ 
ていない場合は、 [ er ] タグで充分です 0 

♦ シナリオ例 

これを読んだら一旦停止。 [1] 

これも読んだら一旦停止。 [1] 

ここで強制的に改行 [ r ] してみます。 [1] 

更に改行 [ r ] してみます。 [1] 

このページはここでおしまい。 [ p ] 

[ er ]¥ 

新しいページ。 [1] 

さらに続く。 [1] 

またページを切り替えようかな。 [p] 

[ er ]¥ 

更に新しいページ。 [1] 

[ er ] タグの後ろに半角の「¥」を記述しているため、 [ er 】 の行は 1 行として見 
なされません。 [ er 】 の行を空行にしたい場合は、 [ er ] の行末の「¥」を取ればそ 
の部分が空行になります。これでページの頭が一行だけ空きます。 
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文字を表示させるだけでなく、文字の背後に画像を読み込むには、 [ image ] 
タグを使います。 

•タク記逋例 


[ image ] タグには他にも数多くの属性がありますが、基本となるのは上の例 

に出てくる3つの属性です。_ 

「 storage 属性」 表示したいファイル名を書きます。フォルダや拡張子は指 
定しなくてかまいません。 

「 layer 属性」 背景画像を表示するレイヤー名である 「 base 」 を指定します。 

「 page 属性」 「 fore 」 はフォアグラウンド、 「 back 」 はバックグラウンドの 
_意味になります。この場合は前面である 「 fore 」 を指定します。 

KAG で扱うレイヤーは、メッセージ•レイヤーであっても画像レイヤーであっても、 
すべてのレイヤーに裏表があります。なぜそれぞれのレイヤーに裏が必要なのかと 
いうと、画面切り替えに用いるトランジション効果 (— Step 2) を行なう場合、切り替 
わる先の画像をレイヤーの裏側に準備しておく必要があるからです。 

このため、フォアグラウンドに画像をロード （ page ^ fore ) すれば画像は即 
座に表示されますが、バックグラウンドにロード （ page = back ) した場合は卜 
ランジシヨンをしないと見えません。 

籲 シナ U 才例 _ 

[image storage = M test 01 . bmp H layer=base page = fore ]¥ 

[ er ]¥ 

背景を表示してみました。 [1] 

見えますか？ [1] 

[image storage 二" test 02 . bmp n layer=base page = fore ]¥ 

背景だけ入れ替えてみました。 [1] 

ちゃんと入れ替わったかな？ [1] 

もういっちょ 〇 [1] 

[image storage = H testOl . bmp n layer 二 base page = fore ]¥ 

[ er ]¥ 

1 枚目に戻してみました。 [1] 

ついでに ページ も切り替えてみました。 [1] __ 


KAG©m 操作 






籲_鬱_ 


背羅瞧耐る[咖辟] 


; て-广ずて+广:ヤ 

: J 




ge 名拡クをど索ル別更るけてをテでてと 
ra ル、•ンほ検ィて変あだめら I クけい 
sto ィ時ルョ-。後でァしにもる含れ才 I つよ 
li アるブシ”、名フ換ル合きでそクマをが 
一でフすダーきしル、»ィ場でま、.ン癖方 1-0 
<3に定やテでだィり括ァい、子しルョるたま 
KA 性指子一略たァた I フたで張記ブシくいい 
属を張才省フしをのしの拡表ダーくお思 
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ゲームに BGM と効果音は必須ですが、これらはそれぞれ一つのタグを書く 
とによって手軽に再生することができます。 


[Playbgml 

BGM を再生する。 

[ sto 陶 _ 

BGM を停止する。 

Padeoutbgm ] 

BGM をフェードアウトする。 

1m 

BGM が鳴り終わるのを待つ。 

Payse ] 

効果音を再生する。 

istopse ] 

効果音を停止する。 


効果音が鳴り終わるのを待つ。 


•シナリオ例 

[er]¥ 

今から BGM を流してみます。 [1] 

[playbgm storage="test.mid"]¥ 

鳴っていますか？ [1] 

1 では止めてみましよう。 [1] 

[stopbgxn]¥ 

いきなり止めると気分が悪いですね。 [1] 

もう一度鳴らしてみます。 [1] 

[playbgm storage 二 ' , test .mid" ] ¥ 

今度はフェードアウトさせてみますね。 [1] 

[fadeoutbgm time=3000]¥ 

3000 ミリ秒、つまり3秒でフェードアウトしました。 [1] 

更に、もう一度鳴らしてみます。 [1] 

[playbgm storage 二 " test.mid”]¥ 

もう一 度、フェー ドアウ ト。 [1] 

ただし、今度のは、フェードアウトが終わるまで次の文字を表示しません。 [1] 
[fadeoutbgm time=3000] ¥ 

[wb]¥ 

はい。ご清聴ありがとうございました。 [1] 

[er]¥ 

続いて効果音のテストです。 [1] 
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KAG の基本操作 


[playse storage: ，_ test .wav" ] ¥ 

鳴っていますか？ [1] 

しばらくしても止まりません。止めるには…… [1] 
[stopse] ¥ 

これで止まったはずです。 [1] 

次は、一度だけ流してみます。 [1] 

しかも、鳴り終えるまで次の文字は表示しませんよ。 [1] 
[playse storage="test.wav" loop=false]¥ 
[ws]¥ 

はい。鳴り終えました。 [1] 


例のように [playbgm storage = M test . mid H ] と書くと、ファイルの終わりに達し 
たら自動的に巻き戻され、再び先頭から音楽や効果音が再生されます。 

ここで、オープニング.テーマやキャラクターの台詞ファイルのように一度 
だけ再生したい場合は、属性 loop を利用します。 


効果音を鳴らす 
[ playse ] タグは、デ 
フオノ！/卜で 「loop 
= falsej となつてい 
ます。つまり、効 
果音を1度だけ鳴 
I らしたい場合は右 
1 のタグ記述例にお 
ける 「 loop = false 」 
は省略できるので 
す。指定した効果 
音を何度も ループ 
I させたい場合のみ、 
10 op 属性を用いて 
noop = true 」 と窨 
きましよラ0 


•タグ記述例 

[playbgm storage^"test.mid" loop=false]¥ 

[playse storage="test .wav ,f 100 p=false]¥ 

この場合、一度再生されたファイルが再生を終了するのを待って次の処理 
を開始した t ゝ場合がありますが、このようなときは [ wl ] タグを使います。 

•タグ記述例 

「ふざけないでよっ！」 

[playse storage="baki.wav M 10 op 二 false] ¥ 

[ws] ¥ 

彼女の鉄拳がぼくの後頭部に炸裂した。 [1] 


で音が一度鳴り終え i ま:^次©+ 


されなくなりました- 


■メッセージ • レイヤーのサイズについて 
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1-3 BGM と効果音を鳴らす [playbgm] [stopbgm] [fadeoutbgm] [wb] [playse] [stopse] [ws] 

■■iliailMfiHIMMRiiiiHiiilMBIHMiMMNHRHeMMHlIifliMRRMHMlaiiiilllMNRMHI 


KAG 


ここまでの例では、「メッセージ.レイヤー0」が画面全体に覆いかぶさるよ 
うなタイプを用いてきましたが、アドベンチャーゲームやビジュアル系のノべ 
ルゲームに見られるような、画面の下部のみに細いメッセージ，レイヤーを表 
示させることもできます。 

これは 「 Config . tjs 」 を書き換えることで可能になります。 


• Config/tjs 例 

function MessageLayer_config() 



// ♦ メッセージレイヤの色と不透明度 

；frameColor = 0x660088 ； // position タグの color 属性に相当 

t デフオルトは「000000」で黒。ここでは「660088」にした。_ 

； f rameOpacity =170 ； // position タグの opacity 属性に相当 



// ♦ 左右上下マージン 



// ♦ 初期位置 


；ml 

= 40; 

// 

左端位置 

；mt 

= 340; 

// 

上端位置 

；mw 

= 560; 

II 

幅 

；mh 

=120; 

// 

高さ 

t メッ 

セージ 

• レイヤーそのものの位置を調整。 



一例として上記のように設定した 「 Config . tjs 」 を用いると、メッセージ • 
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KAG の基本操作 

響 

_ 

レイヤーは画面の下部に表示されるようになります c 基本操作が理解できた 


ら、作りた t 、ゲームのデザインに合わせてメッセージ•レイヤーを変更してお 
くとよいでしょう。 


__ 

シ》ム饫文事 


KAG は、ビジ〇アルノバ:ルやサウンドノベルのような 
ノベル^系ゲームや，選択肢を選んでストー y 一が進む 
ような文字ベースのアドベンチャーゲームを作成する 
ためのキットです。 

KAG は吉里吉里をゲーム エンジン として動作させる 
( ためのスクリプトで、それ自体は TJS スクリプトで書かれ 
ています D KAG 用のスクリプトは「シナリオ」と呼ばれ、 
TJS スクリブトとはまた別のものです。丁 JS スクリフトはブ 
ログラミングの知識がかなり必要になりますが、シナリ 
才はより簡単で記述しやすいものです c ▼ 


全画面表示の例 



アドベンチヤー風の例 


X ?^ r < G } IWtt ^ 菜脱故她 




このようにメッセージ枠の中にメッセージを表示させ 
ることもできます c アドベンチャーゲームで良くある夕 
イプです。 
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トランジシヨン 




ぽ S 1 S 5? 二 ay] 



「トランジシヨン」とは、メッセージ•レイヤーに書かれた文字や画像レイ 
ヤーに表示されている画像を別のものに入れ替えるときに使う機能ですが、 
KAG で提供されているトランジシヨンには以下の4種類があります。 


①クロスフェード • トランジシヨン 


②ユニバーサル.トランジシヨン 


[WS] や [ wb ] と同 
様、処理が完全に 
終了するまで待つ 
ためのタグは wait 
の頭文字を取った 
[ w _】 で始まること 
が多いようです。 



この中で基本となるのは丨クロスフヱード • トランジシヨン」ですが、この 
トランジシヨンの原理を理解してしまえば、他の3つのトランジシヨンについ 
てもほぼ同様に扱えます。 

なお、タグの使い方は4つのトランジシヨンで共通なので、一度覚えてしま 
えば他のトランジシヨンでも応用できます。 

トランジシヨンを行なう場合に使うタグは、 [trans][wt 】 の二つです。 [trans 】 
はトランジシヨンを行なうタグで、 [ wt ] はトランジシヨンが完全に終了するま 
で次の行を実行しないように終了を待たせるタグです。 
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載麗_ 


2-1 トランジシヨンの種類と原理 


•タグ記述例 

[trans method=crossfade tixne=3000]¥ 
[wt]¥ 


トランジションの手順ですが、まずは新たに表示させたい画像を [ image ] 夕 _ 
グを用いて base (背景）レイヤーのバックグラウンドに読み込み、この後 11 
[ trans ] タグを記述することによって、 base レイヤーのバックグラウンドに読 _ 
み込まれた画像をフォアグラウンドに表示します。 III 


修#⑩參參#參 


この流れを表にすると、下のようになります。 


麵__画：〇讓_圖^^ 



mummxm 


_aas:— …— —— 


何もなし 

すでに画像 A を表示中 

画像 B を読み込む 

相変わらず画像 A を表示中 

画像 B を表示中 

画像 A が画像 B へ置き換わる 

画像 B を表示中 

画像 B が表示される 


♦シナリオ例 

[er]¥ 

まずは普通に背景画像を base レイヤーに表示。 [1] 

[image storage= n test01.bmp" layer 二 base page=fore] 
続いて新しい画像を base レイヤーの裏ページへ読み込み。 [1] 

[image storage="test02.bmp" layer=base page=back] 
もう読み込んだのですが、見えませんよね。 裏側 だし。 [1] 
それではいよいよトランジシヨンします〇 [1] 

[trans method=crossfade time=2000]¥ 

[wt]¥ 

トランジシヨンの終了を待って、この行を表示しました。 [1] 
もし [wt] タグを書き忘れてしまうと、以下のようになります 。[: 
[er]¥ 

新しい画像を base レイヤーの裏ページへ読み込みました。 [1] 

[image storage="testOl.bmp" layer=base page=back] 
読み込み完了。トランジシヨンスタート！ [1] 

[trans method=crossfade time=2000]¥ 

書いている文字がトランジシヨンに飲み込まれて消えちゃうよ〜 






トランジシヨン 



うよ〜。消えちやうよ〜。 [1] 

[wt]¥ 

ter]¥ 

あのように消えてしまうのは変なので、 trans タグと wt タグはセットで 
使うことをお勧めします。 [1] 


上のサンプル.シナリオでは、メッセージ.レイヤーはそのままの状態で 
base レイヤーの画像をトランジションさせました。 

ですが、画像が切り替わる瞬間をもっとはっきり見せた I ゝ場合もあると思い 
ます。このような場合は、以下のような考え方をします。_ 

① メッセージ • レイヤーを非表示にする。 

② base レイヤーのみ表示されている状態で画像をトランジション。 

③ メッセージ*レイヤーを再表示する。 


メッセージ. レイヤーを非表示にすれば、当然その上に書かれている文字も 
不可視状態になりますが、 base レイヤーの背景画像がトランジションしている 
間だけなので、問題はありません。 

ここで利用するタグは、レイヤーの各種属性を設定する [ layopt ] タグです、 

[ layopt ] には「 layer 」 「 page 」 「 visible 」 その他の属性があります。この中の 
visible 属性を 「 false 」 にすると layer で指定されたレイヤーが不可視になりま 
す。常用しているメッセージ，レイヤーは 「 messageO 」 なので、下のように 
書きます。 

•タグ記删 

• 非表示にする場合 

[layopt layer=messageO page=rore visible=false] ¥ 


•再表示する場合 _ 

[layopt _ layer^messageO page=fore visible=true]¥ 


の記述を先ほどのサンプル • シナリオに組み込んでみます。 
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トランジシヨンの種類と原理 



籲シナリオ例 _ _ _ 

[er]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage?test 01 .bmp" layer=base page=rore]¥ 
バックグラウンドに画像を表示。 [1] 

[image storage 二 " test02.bmp" layer=base page=back]¥ 

メッセージ レイ ヤ ー 0 のフォア、バックともども非表示にしてから、 ト ラン 
ジシヨンします。 [1] 

[layopt layer=messageO page=rore visiole=ralsej¥ 

[layopt layer=messageO page=back visible=false]¥ 

[trans method=crossfade time=2000]¥ 

[wt] ¥ 

[layopt layer=messageO page=fore visible=true]¥ 

メ ッ セージ レイ ヤ ー 〇 を再表示しました。 [1] 


「メッセージ•レイヤー0」のバックグラウンドを非表示にする理由は、卜 
ランジシヨンの原理と関わっています。 

トランジシヨンはすべてのレイヤーのバックグラウンドに存在するデータや属性を 
フォアグラウンドへ持ってきてしまうので、「メッセージ•レイヤー0」のフォアグ 
ラウンドをいくら不可視にしても、バックグラウンドが可視状態では意味があ 
りません。このため、両方のページを不可視にしておく必要があるわけです。 


rrmz 


ージ*レイヤーのトランジシ: 


[ layopt ] タグを使ってメッセージ.レイヤーを制御するだけでは、パッとを肖 
えたりパッと現われたりするだけで味気がないと思うかもしれませんが、当然 
こちらにもトランジシヨンを用いることができます。 


考え方は、非表示にしたいメッセージ.レイヤーのバックグラウンドをまず 
不可視にし、トランジションを行なって不可視属性のバックグラウンドを文字 
の書かれているフォアグラウンドに転送します。 

こうして見えないものをバックグラウンドから転送したために、フォアグラ 
ウンドの文字や文字枠はトランジション効果によって消えます。 

このような時に必要なのが、 [ backlay ] タグと呼ばれるタグです。これはフォ 
アグラウンドの属性をバックグラウンドにコピーする働きを持っています。卜 





各レイヤーが持 
つ裏べージ ( page = 
back ) は、演劇な 
どの舞台裏に似て 
います。 

お客さんから見 
える場所 ( page = 
fore ) では俳優が演 
技をしていて、見 
えない舞台裏 
( page = back ) では 
役目を終えた俳優 
が一服したり、次 
のシーンの準備を 
したりしているわ 
けです。 


4フ# —- 



トランジシヨン 




ランジシヨン前にこのタグを用いて、全レイヤーの表画面の情報を裏画面にコ 
ピーしておきましょう 


「 


base ® 

1111^^11 

message 0 .back 

message 0 .fofB 


femrnm 

何もなし 

画像 A 表示中 

何もなし 

文章表示中 

\ 

\ 

2 

......パ 

褰麵峨馨 

麵面へコビー 

表から画像 A が 
コピーされたが 
どうせ見えない 

画像 A 表示中 

表から文章がコ 
ピーされたがど 
うせ見えない 

文章表示中 

_ 

ims $ ageO<D 

SCoptl 

\^ zr p] 

画像 A 表示中 

画像 A 表示中 

不可視状態にな 
り文字と文字枠 
が消える 

文章表示中 

4 

讎_ 

_タタで 
トランジシヨン 

画像 A 表示中 

画像 A が裏から 
コピーされるが 
見た目は変化なし 

不可視状態 

不可視状態が裏 
からコピーされ 
て文字と文字枠 
が消える 



画像 A 表示中 

画像 A 表示中 

不可視状態 

不可視状態 


さらに、後半の「メッセージ • レイヤー0」の再表示についてもトランジシ 
ョンで行なうことができます。 



mm 

mmm 

Dasecw 
画像 B 表示中 

base (熟 
画像 B 表示中 

不可視状態 

不可視状態 

■ 

匕 

，一二，/ 
fctj で家寧レイ 

ヤーをリセット 

盗誠惑鐘 觸号釋 

画像 B 表示中 

画像 B 表示中 

不可視状態 

レイヤーをリセ 
ットし、文字枠 
復帰 

: 

SI ビ- 

画像 B を表画面か 
らコピーするが、 
同じ画像だし、 
どうせ見えない 

画像 B 表示中 

リセット状態の 
属性を表画面か 
らコピーしてく 
る 

リセットされた 
不可視状態 

4 

でメッ 

セ—ジレイヤー丨 
の裏齡を可視 

』!!!ご， 

雜 iwirr 

画像 B 表示中 

画像 B 表示中 

可視状態に 

不可視状態のまま 

5 

麵議义クロス 

フエ”ド，' ........ 

画像 B 表示中 

裏画面から画 
像 B が コビー 

_ I 

可視状態 

裏画面から可視 
属性が表画面へ 
P- K 


■ iil la lirriai 

了 

画像 B 表示中 

画像 B 表示中 

可視状態 

可視状態 










ウェイトばつか 
りの ゲームはかつ 
たるいですよね。 














実は [ trans ] タグ 
には children とい 
う属性があり、 
children=false とす 
ると base レイヤー 
の内容だけがトラ 
ンジシヨンされま 
す。 

ただしこの記述 
を行うと演算量が 
膨大になり、メモ 
リを無駄に使用す 
るのでお勧めでき 
ません。 



トランジシヨン 



■ base レイヤーのみのトランジシ 


先ほどまでの例とは逆に、こんどはメッセージ.レイヤーはまったく操作せ 
ず、 base レイヤーに表示されている画像だけを入れ替えてみます。 


先にも述べたように、 [ trans ] タグはすべてのレイヤーのバックグラウンドに 
あるデータや可視不可視の属性をフォアグラウンドに持ってきてしまいます。 
たとえそれが持ってきてほしくないものであっても、バックからフォアに、強 
制的に持ってきてしまいます。それを擬似的に回避するため、 [ backlay ] のよ 
うなページ間コピー用のタグが準備されているわけです。 

base の back に新しい画像を読み込んでトランジシヨンさせたい埸合、 「 mes - 
sageO 」 の back がもし空っぽだったら、トランジシヨンを行なうと、背景は入 
れ替わりますが、文字は消えてしまいます。つまり、メッセージ.レイヤーを 
いじらずに、背景だけ入れ替える作業をするには、ちょっとした工夫が必要に 
なるのです。 

処理手順については次のようになります。 
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このように [ trans ] タグでトランジションを行なうときに「メッセージレイヤ 
一0」に変化が起きていないように見せるには、 [ backlay ] でフォアグラウンド 
から バック グラウンドに同じデータを コピーして おけばいいのです。これによ 
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參參暴 鬱參參響 


ってトランジション時にバックグラウンドからフォアグラウンドへデータが転送 
されても、結局は同じものが行ったり来たりしているだけになります。 


ただ、気をつけなければならないのは、 [backlay] を使うタイミングです。画 
像 B をロードした後に [backlay】 を使ってしまうと、せっかくバックグラウンド 
にロー ドした画像 B が、 [backlay] のおかげでフォアグラウンドにあった画像 A 
に戻ってしまいます。 

トランジシヨンが意図どおりにいかないのは、この [backlay] タグの使い方を 
間違えているケースが非常に多いです。 


•シナリオ例 

[ er ]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage =" test 01 . bmp " layer=base page = fore ]¥ 
backlay タグを使ってメッセージレイヤー 0 のフォアグラウンドのデータと 
属性をバックグラウンドへコピーします。 [1] 

base レイヤーの画像もフォアからバックへコピーされますが、次のステッ 
プで新しい画像をバックにロー ドするので気にしなくていいです。 [1] 
続いて、バックグラウンドに新しい画像をロードし、トランジシヨンしてみ 
ます。 [1] 

[ backlay ] ¥ 

[image storage =" test 02. bmp " layer=base page = back ]¥ 

[trans method 二 crossfade time =3000]¥ 

[ wt ] ¥ 

文字がそのままで、背景画像だけが入れ替わったように見えましたか？ [1] 


■ユニバーサル • トランジシヨン 


「ユニバーサル.トランジシヨン」は“汎用的なトランジシヨン”という意 


味で、「ルール•ファイル」と呼ばれるファイルを自作することによって、無 


限のトランジシヨン，パターンを利用することができます。 


クロスフエー ドでは、画像は単純な フヱー ド効果によって切り替わっていま 
したが、ユニバーサル. トランジションはこの ルール•ファイルの パターンに 
従って切り替わるためです。 
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'上，，::::：：： 

レ■.へ::■パ 

vague 属性にあ 
まり大きな数値を 
入れるとクロスフ 
エー ドと変わらな 
くなってしまいま 
す。 


薄薄 ::' f :: :: 

ユニバーサルト 
ランジシヨンを利 
用するときに指定 
する属性 method = 
universal は省略で 
きます。 

省略するとユニ 
バーサ ル ト ランジ 
シヨンが自動的に 
設定されたことに 
なるからです。 

methods を指定 
する必要があるの 
は、クロスフエー 
ドトランジシヨン 
や後述のス クロー 
；レトランジシヨン 
を利用するときだ 
けです 


圖議:1 
111 * 


111 

_圓__8___^ 


トランジシヨン 


• タグ記述例 _ 

[trans method=universal rule="ruleO 1 .png" time=3000 

vague=100]¥ 

[wt ] ¥ 


属性 「 vague 」 は初めて見ると思いますが、これはユニバーサル.トランジ 
シヨン専用の属性です。数値は境界のあいまい値を表しており、この値が小さ 
いとトランジシヨンはくっきりと行なわれ、大きいとぼんやりと行なわれます。 
通常は100程度にしておき、シャープな切り替えをしたければ数値を下げ、フ 
アジーにしたければ数値を上げるとよいでしょう。 


參シナリオ例 

[er]¥ 

背景画像を base レイヤーに表示。 [1] 

[image storage: 11 testOl .bmp” layer=base page=fore] ¥ 

続いて新しい画像を base レイヤーの裏ページへ読み込み。 [1] 

[image storage?test 02 .bmp" layer 二 base page=back]¥ 

それではトランジシヨンします。ブラインド風のトランジシヨンです。 [1] 

[trans method=umversal rule = " ruleO 1 .png" time = 3000 
vague=100]¥ 

[wt ] ¥ 

別のルールファイルを使ってみましようか。 [1] 

[er]¥ 

もう一度もとの画像を base レイヤーに表示。 [ 1 ] 

Limage storage="testOl.bmp"layer=base page=fore]¥ 

続いて新 U い画像を base レイヤーの裏ページへ読み込み。 [1] 

[image storage="test 02 .bmp" ユ ayer=base page=back]¥ 

今度は円形のトランジシヨン。 [1] 

[trans method=universal rule="ruleO 2 .png" time = 3 0 0 0 
vague=100]¥ 

[wt ] ¥ 

ルールファイルのファイル名をいろいろ変更して試してみてください。 [1] 
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2-1 トランジシヨンの種類と原理 
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ルールフテイルは 「 syokai 」 フォルダの中に2つ入っている他、 CD - ROM 内 
に収録されているトランジション•ライブラリ （ translib 2.1 zh ) にもたくさん 
入っています。 

最初のうちはライブラリのファイルを利用しておいて、表現力が不足してき 
たら自作するとよいでしよう。 


スクロール • トランジシ 


「スクロール， トランジシ ヨン」 は、その名の 通り画像をスクロール させて 
表示するためのものです。 


•タグ3己述例 

[trans method=scroll time=3000 from=left stay 二 stayrore]¥ 
[wt ] ¥ 


from 属性は方向を表わします。 「 left 」 rrightJ 「 top 」「 bottom 」 の 4 種類が 
あるので、演出効果を考えて方向を指定します。 

また、 スクロール. トランジシヨンは1種類のトランジシヨンですが 、 stay 
属性を変更することによって3種類の表現ができるようになっています。 


• stay=stayfore 

表画面の画像の上に、裏画面の画像が from で指定した方向から入ってくる。 


• stay=stayback 

表画面の画像が from で指定した方向へ出て行き、裏画面の画像がその下か 
ら見えてくる。一般の紙芝居の形式。 

• stay=nostay 

表画面の画像が出て行くと同時に裏画面の画像が入ってくる。このため二 
枚の画像が連結されて動 v ゝているように見える。 


特に演出効果として優れているのが、 「 stay = nostay 」 で利用した場合です。 
画面の2倍のサイズに該当する横長または縦長の画像を用意し、それを半 
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[er]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage 二 ,, scrolltestOl , bmp n layer 二 base page=fore] ¥ 
見えませんけど、バックグラウンドに画像を表示。 [1] 

[image storage^"scrolltest 02 .bmp" layer 二 base page=back]¥ 
スクロール トランジシ ヨン。 [1] 

[layopt layer=messageO page 二 back visible=false]¥ 

f 1 ^vnnh 1 ^ v ^ T = ni ^ s . ciarr^n - n 3 rrf=»=f nr ^ si h I 1 ¥ 
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2-2 拡張トランジシヨン 
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拡張トランジシヨン 



「otatezoom ハント 


rotatevanish ハンド〒 


rotateswap ハンド： 


「拡張トランジシヨン」は、吉里吉里のプラグインを利用することによって 
行なうことが可能なトランジシヨンです。 

利用するためには、 krkr 218 フオルダ内にある plugin フオルダの中の 
「 extrans . dll 」 ファイルを、 「 krkr . eXe 」 と同じ場所にコピーする必要があります。 


プラグインとは、 
本来のプログラム 
とは別の状態で配 
布されている追加 
プログラムのこと 
です。 

これを本来のブ 
ログラムに追加す 
ることによ：つて、 
本来のプログラム 
が持つ機能を拡張 
することができま 
す 〇 

要するに、ロボ 
ットの拡張パーツ 
みたいなものです 
ね。空を飛ぶ羽と 
か、地中を進むド 
リルとか。 


現在のところ、拡張トランジシヨンには6種類のノ、ンドラが準備$れています。 
これらを切り替えることによって、さまざまなトランジシヨンが利用できます。 


wave 八ンドラ 


mosaic ハンドラ 


turn 八ン 


、 4 从 _1 IP 

XV •、仙峨 _鱗 

、V け！， 

、& J 、 


謹 



























トランジシヨン 
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拡張トランジション機能はプラグインで提供されていますから、 KAG シナ 
リオの先頭にプラグインをロー ドする1行を書く必要があります。 

•タグ記述例 

[loadplugm modu 丄 e= •’ extrans. dll ，， j ¥ 


籲シナリオ例 

[er]¥ 

画像を base の fore に表示。 [ 1 ] 

[image layer=base page=fore storage:•• testOl .bmp" ] ¥ 
画像を base の back に表示。 [1] 

[image 丄 ayer=base page 二 back storage:"test02.bmp"]¥ 
まずは wave ハンドラによるトランジシヨン。 [1] 

[trans method=wave time=3000] ¥ 

[wt]¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1 】 

Iimage layer=base page=fore storage="testOl.bmp n ]¥ 
[image layer=base page=back storage?test02.bmp"]¥ 
次は mosaic ハンドラによるトランジシヨン。 [1] 

[trans method=mosaic time=3000]¥ 

[wt ] ¥ 
ter]¥ 

次のトランジシヨン用に画像をリセット〇 [1] 

[image layer=base page=fore storage^"testOl.bmp"] ¥ 
[image layer=base page=back storage="test02.bmp"]¥ 
次は turn ハンドラによるトランジシヨン。 [1] 

[trans method=turn bgcolor=0x000000 time=3000]¥ 
[wt]¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer 二 base page 二 fore storage="testOl.bmp"]¥ 
[image layer=base page 二 back storage=." test02 .bmp" ] ¥ 
次は rotatezoom ハンドラによるトランジシヨン。 [1] 
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2-2 拡張トランジシ 


KAG 


[trans metnoa=rotatezoom tactor=：0 time=3000] ¥ 
[wt]¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer=base page=fore storage^"testOl.b 
[image layer=base page=back storage 二 " test02.b 
次は rotatevanish ハンドラによるトランジシヨン。 [1] 

[trans method=rotatevanish time=3000]¥ 

[wt] ¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer=base page=fore storage=”testOl.b 
[image layer 二 base page 二 back storage= H test02.b 
次は rotateswap ハンドラによるトランジシヨン。 [1] 
[trans method=rotateswap time=3000] ¥ 

[wt] ¥ 

これで終わりです。 [1] 
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キャラクターの立ち絵やシルエットなどの画像を読 
み込むには前景レイヤーを利用します。ここでは前 
景レイヤーの使し、方と、立ち絵のア ニ メーシヨンに 
ついて解説します 















籲參#參籲拳 


前景レイヤーは 
論理上無制限の数 
を扱うことができ 
ますが、実質的に 
は PC のメモリやリ 
ソースなどに依存 
するため、1000枚 
も2000枚も使うこ 
とはできません。 

ですが、小さな 
前景レイヤーなら 
30枚や50枚程度使 
用しても特に問題 
はないので、一度 
見た画像をサムネ 
イル表示する CG ア 
ルバムなどに利用 
することができま 
す。 
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前最レイヤーを使ったキャラクタ _ 表示 


前景画像を表示する 


KAG では1枚の背景画像の他に、任意の数の前景を表示させるための「前 
景レイヤー」と呼ばれるレイヤーがあります。これらの前景レイヤーには、主 
としてキャラクター.シルエットや立ち絵などの、背景の上に乗せて利用する 
絵を読み込んで利用します。 

前景レイヤーと背景レイヤーの違いは以下の通りです。 


EH 




枚数 

: :盛^」^ 


^ — 

初期状態 ^一 


v …ハ沖、 

画像の移動 
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〇〜3枚（論理上は c 


非表示 


可 


1枚 


表示 


不可 


前景レイヤーに画像を表示する方法は背景レイヤーの時とほぼ同じですが、 
前景レイヤーを指定した時のみ利用できる属性が2つ追加されます。 

•タグ記述例 


[image storage :" charatestOl.bmp ' 
left =200 top =0]¥ 


layer =0 page 二 fore 


top 属性は前景レイヤーに読み込む画像ファイルの上端位置を、 left 属性は 
左端位置を指定するために使います。この属性を省略すると、画面の左上を 
基点として前景画像が表示されます。 

また、前景レイヤーは最初は非表示になっているので、前景レイヤーを利用 
する前に必ず [ layopt ] タグを用いて前景レイヤーを利用可能にします。 

•タグ記述例 


L 丄 ayopt layer =0 page=fore visible = true ]¥ 
[layopt laver =0 page=back visiDle = true ]¥ 


上の記述例では、前景レイヤー 0 のフォアグラウンドとバックグラウンドの両 
方を可視状態にしていますが、必要に応じて片方だけ利用してもかまいません。 
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參シナ1»才例 

[er]¥ 

背景を表示します。 [1] 

[image storage="testOl.bmp H layer=base page 二 fore]¥ 

前景レイヤー 0 のフォアグラウンドを可視状態にします。 [1] 

[layopt layer=0 page=fore visible=true]¥ 

左上に黒い四角が見えるのは、前景レイヤーを可視状態にした時に何も画像 
が表示されていないことを聱告するためのものです。 [1] 

画像を読み込めば消えるので、前景のキャラ絵を前景レイヤー 0 のフォアグ 
ラウンドに表示してみましよう。 [1] 

[image storage 二 " akira.png"layer=0 page=rore top=0 
left=200]¥ 

[er]¥ 

表示されました。 [1] 

続いてトランジシヨンで表示してみます。 [1] 

前景レイヤーを開放します。 [1] 

[freeimage layer=0]¥ 

[er]¥ 

[image storage:"test02.bmp" layer=base page=fore]¥ 
[backlay]¥ 

背景を base レイヤーのフォアグラウンドに表示し、ついでにバックグラウ 
ンドにもコピーしておきました。 [1] 

続いて、前景レイヤー 0 のバックグラウンドを可視状態にします。 [1] 

[layopt layer =0 page=back visible 二 true] ¥ 

前景のキャラ絵を前景レイヤー 0 のバックグラウンドに表示します。 [1] 

[image storage 二，， akira.png” 丄 ayer = 0 page=back top=0 
left=200]¥ 

見えませんよね。 [1] 

それでは、トランジシヨン。 [1] 

[trans method=crossfade time=3000]¥ 

[wt]¥ 

トランジシヨンで前景が表示されました。 [1] 



前最レイヤーを使ったキャラクター表示 




前景画像はキャラクターの立ち絵やシルエットですから、色が置かれている 
部分以外の部分は透明になっていないとゲーム内で使えません。 

このため、前景画像を作る場合にはいくつか注意しなければならないことが 
あります。 

まずは、グラフィック•ソフトで絵を描く時に、背景の部分に何も色を乗せ 
ず、あくまでも透明の状態で書くことです。 

作成したファイルは a チャンネルと共に保存しますが、この状態ではまだ 
KAG では読み込めな I ゝ場合もあります。 

そこで利用するのが、 kirikiri 2 フォルダ内の「 graphconvj の中にある、 
「 krkrtpc . exe 」 というプログラムです。 

これをダブル•クリックで起動し、前景画像として利用したいファイルをウ 
インドウの上にドロップすれば、 KAG で読むことのできるフアイル形式に変換 
して出力してくれます。 
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前景画像のアニメーション 



前景画像のアニメーシ 


前景レイヤーに表示させた画像は、もしそれがアニメーション形式のもので 
あれば自動的にアニメーションを行ないます。 

例をあげると、美少女系のアドベンチャーゲームにある目パチやロパクなど 
ですが、ファイルを準備しておけば KAG の方で勝手にアニメー ションを実行 
してくれるので、シナリオへの記述については通常の前景画像を読み込む書き 
方とまったく同じです。 

前景レイヤーに表示させるキャラクターをアニメーションさせる場合に必要 
なものは3つあり、ベースになる画像ファイル、アニメーションする部分のみ 
を集めたアニメーション用画像ファイル、そしてアニメーションの秒数やコマ 
を指定する ASD ファイルです。これら3つのファイルは、以下のように名前 
の付け方が決まっています。 



名前の付け方 

サンブル 例 

ベ-ズと萌鼸像ファイル 

任意のファイル名 .png 

akira.png 

ーァニ; TT シヨ 孓 ファーイル 

任意のファイル名 _ a_png 

akira 一 a.png 


任意のファイル名 . asd 

akira.asd 


これらのファイルは3つまとめて同一のフォルダに置いておく必要がありま 
す。フォルダはどこでもかまいませんが、管理のしやすさを考えた場合、 「 fim - 
age 」 や rosier 」 がよいでしょう。 

ASD ファイルの中は、以下のようになっています。 

*go 

@loadcell 

@loop 

/ 

©macro name^copyone 

@copy dx=62 dy=179 sx=%x sy=0 sw=90 sh=55 

©endmacro 

7 

*start 

@copyone x=0 
@wait time=100 
@copyone x=90 
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前景レイヤーを使ったキャラクター表示 


@wait time=100 
©copyone x=180 
@wait time=70 
@copyone x=90 
@wait time=70 
@copyone x=0 
@wait time=3000 

f 

@jump target=*start 


KAG シナリオ上 
では位置合わせが 
非常に難しいので、 
画像処理ソフト上 
でピクセル単位の 
位置決めをしてか 
ら KAG に持ってき 
たほうがいいでし 
よラ。 


ASD の内容はサンプル例ですが、必要に応じて「=」の後ろにある数値を修 
正してください。それぞれの数値の意味は、以下のようになります。 

• f@copy dx =62 dy = l 79 sx=%x sy =0 sw =90 sh =55 J について 


dx=62 dy=179 


これは アニメ ーション 用の画像を ベース 画像 
の左上から何ピクセルの位置に アニメーション 
ファイルの パターン セルを表示するかを指定す 
る値です。 「 dx 」 が横ピクセル数で、 「 dy 」 は 
縦ピクセル数です。 

両方とも「0」にするとアニメーションパタ 
ーンがベース画像の左上に表示されます。ま 
た、数値をベース画像のサイズ以上に指定す 
るとベース画像の外に出てしまい、表示されな 
くなります。 



sx=%x sv=0 


これは アニメーション 用の画像から1枚ごとのセルを切り出す位置を指定す 
る値です。ここでは マクロを 使って表記されているのです が、 意味は分からな 
くても数字だけ修正すればすぐに利用できます。 （マクロ —Step7) 
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前景画像のアニメーション 

馨⑩#癱 

sw=90 sh=55 _ 

これは アニメーション 用の画像に含まれているセルの1つあたりのサイズを 
指定する値です。サンプルでは90ドット X 55ドットのセルが3枚並んで270 X 
55ドットの アニメーション. ファイルになっていますが、指定するのは1枚の 
大きさですから「90」と「55」になります。 



籲その他の部分について 

*start 

@copyone x=0 
@wait time=100 
@copyone x=88 
@wait time=100 
@copyone x=176 
@wait time=70 
@copyone x=88 
@wait time=70 
©copyone x=0 


この中から 「 @ copy one x=J の行だけを抜き出して、 x の値を先ほどの 
(sx, sy) の部分に代入してみると、 
sx=0 sy=0 
sx=90 sy=0 
sx=180 sy=0 
sx=90 sy=0 
sx=0 sy=0 


麝#働 
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前景レイヤーを使ったキャラクター表示 


鬱 

雜 

となります。 Z ； れは何をしているかというと、アニメーション•ファイルの1 
枚ごとのセルがどの位置から始まるのかを指定しているのです。 


1枚 目のセルには、 アニメーション • ファイルの左上を原点として （0,0) の 
位置から 「 sw =90 sh =55」 で指定されたぶんの画像が当てられます。2 枚 目の 
セルには、 アニメーション. ファイルの左上を原点として（90,0)の位置から 
「 sw =90 sh =55」 で指定されたぶんの両像が当てられます。3 枚 目のセルには、 


アニメーション•ファイルの左上を原点として（180,0)の位丨置から 「 sw =90 
sh =55 j で指定された分の両像が当てられます： 4枚 目のセルには、2枚 B の 
セルで選択した画像がそのまま当てられます P 5枚 目のセルには、1枚 U のセ 
ルで選択した画像がそのまま当てられます。 



ここまでで、目を開いている状態から一度閉じ、さらにまた開くまでのサイ 
クルが アニメー ションとして記述できたことになります。 

ここまでの例のように、横にアニメーシヨンのセルパターン 
を配置する場合は、 「 sy 」 の値は常に「0」になりますが、右の 
ような縦置きのアニメーションパターン.ファイルを利用する場 
合は、逆に 「 sx 」 が常に「0」で、 「 sy 」 をマクロで変化させて 
いく必要があります。 

• ASD ファイル例 

*go 

©loadcell 
©loop 
7 

©macro name 二 copyone 
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前景画像のアニメーシ 



@copy dx=62 dy=179 sx=0 sy=%y sw=90 sh=55 
@endmacro 

f 

*start 

@copyone y=0 
@wait time=100 
@copyone y=55 
@wait time=100 
@copyone y=110 
@wait time=70 
@copyone y=55 
@wait time=70 
@copyone y=0 
@wait time=3000 

@jump target 二 ★start 

最後に [ wait 】 タグで指定された秒数ですが、これはアニメーションの次セル 
を表示するまでに待つ時間を指定します。抜き出して並べてみると、以下のよ 
うになります。 



開いている状態から閉じる状態までは 0.1 秒刻み、閉じている状態から開い 
た状態までは0.07秒刻みにしてあります。 

いちばん下にある [ wait ] タグは、瞬きをしてから次に瞬きをするまでの間隔 
を指定するもので、ここでは3秒にしてあります。 



まぶたは下ろす 
速度よりも上げる 
速度を少しだけ早 
くしたほうが自然 
だと W . Dee さんか 
ら教わりました。 
彼はこのようなこ 
とをよく観察して 
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前最レイヤーを使つたキヤラクター表示 


■前景画像の移動 [ move ] [ wm ] 


前景レイヤーに表示させた画像は移動させることができます。このような場 
合は [ move ] タグを使います。通常は移動が完全に終了してから次の命令を行 
なわせることが多いため、必要ならば移動の終了を待つ [ win 】 タグも使 t ゝます。 


KAG でタグを記 
述する塌合は、 r_j 
や「•」の数が偶数 
でないとエラーに 
なります。 

「-」，「•」は何 
かをクオートする 
(括る）ために用い 
る記号なので、奇 
数の場合は終わり 
が閉じていないこ 
とになるからです。 

変数や条件分岐 
を扱う上で、思つ 
たように勵かずエ 
ラーが 出るのは * 
このクオーテーシ 
ヨ ン マークが 対に 
なっていない場合 
が ほとんどです。 



•タグ記述例 

[move layer=0 time=3000 path= H (640,0,255) ,f ]¥ 
[wm]¥ 


「 layer 属性」では移動させる画像が表示されているレイヤー名を指定する 
ので、この場合は「前景レイヤー0」を指定します。 

「 time 属性」には移動を行なう時間を指定します^ 

「 path 属性」には、移動先の（ X 座標、 Y 座楞、レイヤーの濃度）をそれ 
ぞれ指定します。 

「 X 座標」の値は、両面全体の左上を「0」として、表示されている_像の 
左端が右側に何ピクセルの位置まで移動するかを指定します。後述のシナリオ 
例の場合は画面の右端を指定したので、画像は幽面の外へ向かって出て行く 
ことになります。 

「 Y 座標」も同様ですが、こんどは縦位置です。画面全体の左上を「0」と 
して、表示されている画像の上端が下側に何ピクセルの位置まで移動するかを 
指定します。後述のシナリオ例の場合は「0」なので、垂直方向へは移動しな 
いことになります。 

「レイヤー濃度」は、前景レイヤーの透明度を操作する値です。「255」な 
ら何も変わりませんが、「0」にすると完全に透明になります。中間値を設定 
すると半透明になります。 
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前景画像の移動 [ move ] [ wm ] 


KAG 


•シナリオ例 _ 

[er]¥ 1 

背景を表示します。 [1] 

timage storage 二 " test 01 .bmp M layer=base page=fore]¥ 

前景レイヤー 0 のフォアグラウンドを可視状態にしてから、前景のキャラ絵 
を前景レイヤー0のフォアグラウンドに表示してみます。 [1] 

[layopt layer=0 page=fore visible=true]¥ 

[image storage="akira.png M layer = 0 page = fore top 二 0 
left=200]¥ 

表示されました。 [1] 

では、右のほうへ移動させてみましょう。 [1] 

[move layer=0 time=3 000 path 二 ,, （ 640,0,255 ) ” ] ¥ 

[wm] ¥ 

移動しました。 [1] 

[er]¥ 

もう一度背景を表示します。 [1] 

[image storage= 11 test02 .bmp" layer=base page=fore]¥ 

もう一度前景レイヤー 0 にキャラ絵を表示。 [1] 

[layopt layer=0 page=fore visible 二 true]¥ 

[image storage="akira.png"layer=0 page 二 fore top=0 
left=200]¥ 

表示されたので、今度は下のほうへ移動させてみます。 [1] 

しかも、最終的には透明になるようにしてみます。 [1] 

[move layer*=0 time 二 3 000 path=”（2 00, 480, 0) ” ]¥ 

[wm] ¥ 

消えてしまいました。 [1] 
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If 


画像だけでなく文字表示においても細かし■整が 
行なえる点は吉里吉里/ KAG の魅力です。ここ 
では文字表示に関するテクニックを解説します。 




文字表示のテクニック 



















文字表示のテクニック 




フオント釀 I による文字装飾 [ f 0 _[__ 0 補 


r 〆 




■ • 

color 属性に指定 
されている OxffOOOO 
は、色を RGB の16 
進数で表したもの 
で、この場合は赤 
色を指定していま 
す。 

これらの カラー 
コードは html のも 
のとまったく同じ 
ですから、手持ち 
の html エディタの 
カラー パ レツ トか 
ら16進数表記を確 
認すれば、どの色 
にどの数字を使う 
のかが簡単に分か 
ります。 


_ 


size 属性に指定 
される数値はピク 
セル単位です。 
html のフォント指 
定パラメータとは 
異なるので注意し 
てください。 



KAG シナリオに書かれた文字は、 「 Config . tjs 」 内で指定された色や大きさ 
で画面に表示されますが、これは [ font ] タグを使うことによってシナリオ中で 
任意に変更することができます。 

•タグ記述例 

[font color=0xff 0000 size=25 face="MS 明朝 "] I 

[font color=default size=default face=default] 

[resetfont] 


シナリオ内に [ font ] タグが書かれると、それより後の部分がタグで指定され 
た文字属性に従うようになります。 

色や大きさを元に戻したい場合は、2行目の [font color ^ default ....] のような 
書き方をして各属性を 「 default 」 に戻すか、すべての属性を一気に rConfittjsJ 
で指定された値に戻す [ resetfont 】 タグを使います。 

2行目のような書き方は、一部戻したくない属性がある場合などに利用し 
ますが、 [ font ][ resetfont 】 をペアで利用したほうが、 html の「く font >〜</ font >」 
のような認識ができるため、理解しやすいと思います。 

•シナ U 才例 _ 

洞窟を進んでいくと、足に何か当たった。 [1] 

ゆっくりと懐中電灯の光を向けてみる。 [1] 

光の中に浮かび上がったのは、変色した [font color=0xff 0000 ]頭蓋骨 
Lresetfont] たった。 [1] 

[font size=52] 「うわあ！」 [resetfont][1] 

ぼくは大声を上げると逃げ出した。 [1] 
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実行画面 












4-2 文字の表示速度 [ delay ] [ nowait ] [ endnowait ] 

: ■ . ■ • ■ . ■ ■. . 





文 _^ 酺 __3_ nowa_ fen_w 制 


s li 


KAG シナリオに書かれた文字は、 「 Config . tjs 」 内で指定された速度で表示 
されますが、これは [ delay 】 タグを使うことによってシナリオ中で任意に変更す 
ることができます。 


•タグ記述例 

[delay speed=500] 


「 speed 属性」には、文字を表示させる間をミリ秒単位で指定します。500 
の場合は、1文字表示するごとに 0.5 秒待つことになります。 

これも前述の [ font ] タグと同様に、タグが書かれた位置からタグで指定され 
た速度に従って表示されます。 

元に戻す場合は 「 speed = user 」 としますが、これはユーザーがプレイ時に吉 
里吉里のメニューで文字の表示速度を変更している場合があるからです。 

•タグ記述例 

[delay speed=user] 


意味としては 「 speed = default 」 なのですが、その規定値が user に委ねられ 
ているため、このような表記になります。 

また、ウェイトを「0」にして一気に表示させる場合は、 speed 属性に以下 
のように指定します。 


參シナリオ例 

まずは普通に。 [1] 

Ldelay speed=nowait] ¥ 
ここだけ一気に表示する。 [1] 
Ldelay speed= user] ¥ 
元に戻しました。 [1] 


これは、 [ nowait ] タグを用いて次のように書くこともできます。 



多くの場合、ユ 
ーザーは最高速で 
メッセージを表示 
させていることが 
多いようです。ち 
なみに私もそうな 
のですが、どうし 
て市販のゲームは 
あんなにメツセー 
ジ表示速度が遅い 
んでしよつね。ま 
さかクリァ時間を 
意図的に引き延ば 
すため……？ 


•; 

11111 


:: 

:ベ::：:::: 
mmm 

ぐ 

•. . 

..へ.：： 


r 」 巧 . 


11111 
靈:+幽； 

111 

; w :…ぺ 

___ 
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文字表示のテクニック 

没應:麵_泠»蠻芻蔡運_讓織®鐵:激®黴次. . ， ..■ 


♦シナリオ例 


私の場合は、速 
度を細かく調整す 
る場合は [ deiay ] 夕 
グを、一気に表示さ 
せる場合は [ nowait ] 
タグを使っていま 
す0 



作り手と遊び手 
の意識の差がいち 
ばん出るのが、こ 
のウェイト処理で 
すね。 

「遅いぞ一遅い 
ぞ一」と首いなが 
らボタンや キーを 
押しまくつた経験 
は誰にでもあると 
思いますが、この 
あたりはできるだ 
け ユーザーフ レン 
ドリーな仕様にし 
てあげましょう。 


まずは普通に。 [1] 

[nowait j ¥ 

ここだけ一気に表示する。 [1] 
[endnowait] ¥ 

元に戻りました。 [1] 


ウェイトを掛けないのなら、こちらのタグのほうが扱いやすいと思います。 


■文字の表示ウェイト [ wait ] 


文字を表示しているときに、次の文字を表示するまでに一定の時間待たせ 
たいことがありますが、このような場合は [ wait ] タグを用います。 

•タグ記逋例 

[wait time=500]¥ 


•シナ U 才例 

厂「どついつことなのよ！」 [1] 

[wait time=1000]¥ 

「じ .[wait time=1000] 実は .[wait time=1000] これには深いわ 

けが……」 [1] 

「もっとハキハキしゃべりなさいよ！」 [1] 


実は、この [ wait ] タグはクリツク連打による読み飛ばしができてしまいます。 
演出の都合上どうしても待たせたい場合には、属性 canskip を使って、以下の 
ように書きます。 

•タグ記述例 

[wait time=500 canskip=false]¥ 


このように書かれた [ wait ] タグは、ユーザーが何をどうしようと必ず指定の 
時間だけ待つようになります。あまり多用すると嫌がらせになるので、注意し 
てください。 
















4-3 文字の位置表示 [ locate ] [ style ] [ resetstyle ] 

m m m m 

文字の位置表示 !; locate] [style] [resetstyle] 

KAG シナリオに書かれた文字は、 「 Config . tjs 」 内で指定された「メッセージ 
レイヤー0」上に順番に表示されますが、 [ locate ] タグを用いることによって任 
意の場所に表示することができます。 

•タグ記述例 

[locate x=100 y=200] ¥ 


また、センタリングや左詰、右詰などをした t 、場合は [ style ] [ resetstyle 】 タグ 
を使います。 

•タグ記述例 

[style align=center] ¥ 
l_resetsty 丄 e] ¥ 

align 属性は、「横書き」の場合は 「 left 」「 center 」「 right 」 のいずれかを指 
定します。「縦書き」の場合は、 「 top 」「 center 」「 bottom 」 のいずれかを指定 
します。 

位置を元の状態に戻す場合は、 align 属性に 「 default 」 を指定するか、 [ reset - 
font ] タグを使います。 
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•シナリオ例 _ 

*start 

[locate y=300] ¥ 
[nowait] ¥ 

[style align=center]¥ 
ゲームを はじめる 
セーブデータを ロー ドする 
ゲー厶 を 終了する 
[resetstyle] ¥ 
[endnowait] ¥ 

[ s ] 




m mm 
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文字表示のテクニック 

錐 


インライン画像の表示 [ graph ] 


SBI__ 
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「 ffOOff 」 はビン 
ク色、 「 ffOOOO 」 は 
真っ赤、 ff 9000は 
オレンジ色です。 
オレンジ色のハー 
卜というのも変で 
すが。 


KAG では、アスキーテキストとして表示可能な文字の他に、オリジナルの 
絵文字も他の文字と同様に扱うことができます。 

これらの絵文字につ t ゝては、前景レイヤーに表示するキャラクターの立ち絵 
と同様、透明処理された PNG ファイルが推奨されています。 

このようなオリジナルの絵文字を KAG では「インライン画像」と呼び、表 
示するためには [graph] タグを使います。 


•タグ記述例 

Larapn storage="heart.png" char=false]¥ 


上の記述例では、" heartpng" というファイルで提供される絵文字がインライン画 
像として1文字提供されます。シナリオに書き込む場合は以下のようになります。 


•シナリオ例 

A 卞 . 取近 [graph storage= "heart. png" char=false] しぐ ^)? [1] 
B 子：してるよ 一 [graph storage:"heart.png” char=false][1] 


属性 「char」 に 「true」 を指定した場合はインライン画像を文字として扱 
い、 「false」 を指定すると本来の画像として扱うようになります。 


「true」 にしておくとインライン画像自体を [font】 タグでさまざまな色に変える 
ことができるので、こちらのほうが便利です。 

•シナリオ例_ 

A 子：最近 [font color=0xff00ff][graph storage:"heart.png" 

! char=true] [resetfont] してる？ [1] 

B ナ •して 匀よ一 [font color=0xff 0000] [ graph storage: "heart .png" 
char=true][resetfont][1] 

A 子：うお、真っ赤だ。燃えてるね。 [1] 

B 子：う一ん、そつでもなし、0実は [font color=0xf f 9000] [graph 
storage: "heart .png" char = true] [resetfont] って感し 0 [1] 

A 子：たそがれてるの？ [1] 
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このように、1つの fheart.pngj をさまざまな色で扱うことができます。 










4-3 文字の位置表示 [locate] [style] [resetstyle] 



「 / i : つの I ミと (上‘？」 

ぼくが訊ねると老人は,1つた。 

「 ©Lvf しの五つ じ や」 




■ルビを振る [ ruby ] 


KAG で扱う文字は、それがひらがなだろうがカタカナだろうが漢字だろう 
が、すべてに対してひらがなだろうがカタカナだろうが漢字だろうがあらゆる 
種類のルビが振れます。この場合、 [ ruby ] タグを使います。 

•タグ記述例 




だからといって、 
ひらがなに漢字の 
ルビなど振らない 
‘ように。 


[ruby text :" ふりがな"] 

[ ruby ] タグの直後にある文字一文字に対して、 text 属性で指定した文字がル 
ビとして割り当てられ、横書きの場合は文字の上に、縦書きの場合は右側に 
表示されます。 


[ ruby ] タグに関し 
ては次に漢字など 
の文字がくる都合 
上、タグ行末に半 
角の¥は絶対に害 
きません。 


•シナリオ例 

「 [ruby text ="つ"]盂 [ruby text 二 , •ら , •] 蘭 [ruby text = "ぼん"]盆 
[ruby text 二"え"]会って何でしようね」 [1] 

ぼくが言うと、藤井さんは呆れたように言い返してきた。 [1] 

「この [ruby text = ••ご"]期に及んでそんなことはどうだっていいだろう 
か。頭を [ruby text = •，フォ”]初 [ruby text = "—マ"]期 [ruby text= M 
ット"]化しろってんだ」 [1] 

ルビのサイズはシナリオ内で任意に変更することはできず、 「 Config . tjs 」 内 
の設定によって決定された値が最後まで引き継がれます。 

ルビを美しく見せるためには、本文の文字サイズや行間サイズにも注意しな 
ければいけません。 

また、これは出版物でも词じことが言えるのですが、1文字や2文字の少 
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文字表示のテクニック 
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# 

_ 

数の文字に長いルビを普通に振るとルビ同士が重なって読めませんし、ルビの 
サイズを小さくすると、字が見えなくなってしまいます。 


このような時は、最初の一文字に対して一気にすベてのルビを振るのです 
が、そのときにルビテキストの先頭に数文字の空白を入れてルビの位置を手動 
で調整します。 


參シナリオ例 



うすると、美しいルビを振ることができます。 


インデント機能 [ indent ][ encHndent ] 


ドラマの脚本のようなレイアウトをしたい場合には、 [indent] [endindent] 夕 
グで提供されているインデント機能を使います。 


參シナリオ例 

[font face = "MS 明朝”]¥ 

お釈迦様 「[ indent ] これは目連ではないか。一体どうしたのじゃ？ 何か 
困ったことでもあるのか？」 [ endindent ][ 1 ] 

目連 「[ indent ] はい、実を申しますと、亡者となった母が餓鬼道に落 
ちて苦しんでいるのでございます。何とか救おうと努力したのですが、供え 
! た食物は全て炎の玉となって燃え上がり、母は何も食べることができずにお 
I ります」 [ endindent ][1] 

I 

お釈迦様 「[ indent ] そうか……。では、その理由がお前にわかるか？」 
[ endindent ][1] 
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4-3 文字の位置表示 [locate] [style] [resetstyle] 



吉里吉罜 


: 菜！^姻：:: 




お釈迦様「これは1:1連ではないか、， • 休どうした 
のじや？ 何か№1ったことでもあるの 
か‘？」 

n 速 「はい、実を申しますと、亡者となった 
母が餓鬼道に落ちて巧しんでし、るので 
ございます。何とか救おうと努力した 
のですが、供えた食物は令て炎の K と 
なって燃え I :がり、母は何も食べるこ 
とができずにおります】 

お釈迦様丨そうか……。では、その卵由がお前に 
わかるか ？」 T 


先頭に [ font ] タグを置いた例 


t 吉里吉至 


園釅_ 


逆ム © 邊予 — 菜金證——歷— 


お釈迦様「これは I ]速ではな I 、か。-体どうしたのじや 
. ? 何か W ったことでもあるのか？ j 

U 速 「はい、〔起を中しますと、 il ： 者となった母が餓 
鬼逍に落ちて苦しんで v 、るのでござ I 、ます。 
何とか救おうと努力したのですが、供えた食 
物は全て炎の玉となって燃え h がり、母は何 
も食ベることができずにおります」 

お釈迦様「そうか……〇では、その押:由がお前にわか 
るか？」， 


[ font ] タグの行を外した例 


デフォルトのフォントは rConfittjsJ 内でプロポー ショナル•フォントが 指 
定されているので、自動的に字詰めが調整されますが、使いにくい場合は シナ 
リ オ例 のよう に等幅 フォントを 指定す る とよいで しょう。 
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4-4 KAG の文字配置座標について 

ド ’ S V ガ落:ごと;:^ ハ: V へ#^4.:ナ.势.◊吒:ぢ>:;」く ： J ^：；： ：, : v ' . 

錐_參籲 

初期位置はメッセージ • レイヤーの黒い四角の位置とサイズを決めており、 

左右上マージンは、その黒い四角の上に実際に文字が表示される場合の位置 
を決めています。 

禁則処理に使う右文字マージンは、縦書きでは下文字マージンになり、句 
点や句読点、カッコの終わり、疑問符や感嘆符などが行頭に表示されないよ 
うにするためのスペースとして使われます。 

これらのすべては [ position ] タグで変更することができます。 

•タグ記述例 

[position layer 二 messageO page=fore marginl =8 margint =28 
marginr =8 marginb =8 left =16 top =16 width =608 height =448]¥ 

「 Congif . tjs 」 で指定された内容と上記のタグは、同一内容になります。 

[ position ] タグで変更されたメッセージ•レイヤーの属性をリセットするタグ 
は存在しないので、上記のようにデフォルトの値を記述した行を1つ準備して 
おくと、変更を戻すときに便利です。 

文字のサイズや行間については、 「 Config . tjs 」 の以下の部分で指定されます。 

• Config.tjs 例 

// ♦ 文字の大きさ 
；defaultFontSize =18; 

// ♦ 行間 

；def aultLmeSpacmg = 2 ； 


rConfig.tjsJ の行間で設定された幅と、文字の大き 
さで指定されたフォント•サイズを元に予約された幅 
が、交互に並びます。文字表示が横書きに設定されて 
いる場合は、「幅」ではなく「高さ」になります。 



函 

_參_ 
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分岐処理のあるノベル系ゲームなどを作るには選 
択肢の知識は必須です。ここでは選択肢文字表示 
に関するテクニックを解説します。 



■ 

r 

- 1 ] 


h KAw I 

^ it f 


f * b 









•タグ記述例 


target 属性には選択されたときにジャンプする先を「*名前」の形式で指定しま 
す。これを「ラベル」と呼びます。ラベルは半角の「*」（アスタリスク）印で始 
まる任意の文字列であることが条件となっており、これが存在しないと、リンクを 
クリックしたときにエラーになるので注意してください。 [ link ] [ endlink ] タグと半 
角の「*」印で始まるラベルは切っても切れない関係にあります。一緒に理解す 
るとよいでしょう（ラベルについては次項で詳しく説明します)。 

また、 [ link 】[ endlink 】 で選択肢を配置した場合は、必ずその最後に [ s ] タグを置く 
必要があります。 [ s 】 タグはシナリオの実行を強制的に停止するためのもので、プレイ 
ヤーが [ link ][ endlink ] で配置された選択肢を選ぶのを永遠に待ち続けます。これを 
置かないと、 [ link ][ endlink ] の次に書いたシナリオがどんどん実行されてしまい、最 
悪の場合は画面がクリアされて選択肢が消えてしまう事態が発生してしまいます。 

•シナリオ例 

洞窟は右と左に分かれていた。 [1] 

どっちへ行こうか。 [1] 

[link target 二 *scene01] 右手へ進む [endlink] 

[link taraet 二 * scene02] 左手へ進む [endlink] 


html を取り扱え 
る人は KAG のタグ 
をそれほど苦もな 
く理解できると思 
いますが、逆もま 
た然り。 

KAG のタグ打ち 
に憤れた方は、自 
分の ホームページ 
を html タグを打ち 
ながら作ってみる 
のもよろしいかと。 


市販のアドベンチャーゲームを起動すると、『ゲームを始める』『セーブデータを 
ロードする』『ゲームを終了する』などの選択肢が並んだメニュー画面が表示され 
ますが、これらのメニュー画面は KAG の選択肢機能を利用じ T 作ることができます。 


必要なタグは [ link ][ endlink ] の二つで、このタグで挾まれた部分がマウスやキーボ 
ードで選択可能になり、指定されたジャンプ先にジャンプできるようになります。考 
え方は、 html の 「< AHREF =***. html > ここをクリックしてね </ A >」 と同じです。 



[link target=*scene001] 石手へ進む [endlink] 
[link target=*scene002 ] 左手へ進む [endlink] 
[s] 



S は行が^:をさべ一い取は、。 

す rfill 
グマ選る角とり肢で行つけ 
コくれ半るな択ん肢にて 

_ ilsIIIT^^^ 


普で表行記れて列ま 


1一 


>オた行ググん命てにシ1シせ夕の 
タリれ実タタどてけぅク I ^てさ S1 5 P 
心ナかを [S] 止はけ練ょア M い止 d sto K 
g シ窨令、停合向し ro のにね«停には t * 
^のら命でな場に行 tt 肢 I 委をを^0み源^ 
かにのぅい下実い択ザをクオょな語字 
^ 2上番るよなんをま選 I ン P リしちの文 
% は順すのがど令しユョ [S ナまグ頭 
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★sceneOl 

[er]¥ 

ぼくは右手へ進んだ。 [1] 
洞窟は行き止まりだった。 [1] 
ぼくはそこに座り込んだ。 [1] 


*scene02 

[er]¥ 

ぼくは左手へ進んだ。 [1] 

外への出口が見えてきた。 [1] 
ぼくは思わず駆け出していた。 [1] 


上の例における半角の「；」（セミコロン)で始まる行ですが、これはシナリオ 
を見やすくするための「セパレータ」です。シナリオは上の例のようにラベルごと 
に分けたほうが見やすいので、それぞれの [ s ] タグの直後に置きます。 [ S ] タグはそ 
こでシナリオの実行を永遠にストップしてしまうので、 [ s 】 タグをまたいだ上下の 
つながりはないためです。 

セパレータ については、どんなものでも構いません。半角の「；」 （セミコロン） 
が行頭にある場合、 KAG はその行を「注釈文」として解釈し、実行しないからです。 

•セバレータ例 __ ___ 

；〇參〇參〇•〇參〇參〇•〇•〇•〇•〇•〇•〇# 

；]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]] 

；######################## 

上のセパレータのように、セミコロンの後ろは何でもかまわないので、自分がい 
ちばん見やすいものをセパレータとして決めておくとよいでしよう。 
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選択肢とラベル 

:: .し:.:.;:.::...: て:::.:: ::;:賴霉^ 減":::㈣ .ベ.:..'.'. 

修 

籲 

また、それぞれのラベルの直後に置かれている [ er 】¥ ですが、これがないと、ぺ 
ージが切り替わったように見えず、選択肢の直後にジャンプ先のラベルの内容が表 
示されてしまいます。 


吉罜吉罜 ________ _____ mmm ] 


ーシステム⑤文芊表碰鎌卿菜機_薩秘ヘルプ妙抑_ 


洞窟は. f ! 上ん:に分かれていた。 
どっちへ行こうか。 

右 : r •へ進む 
/)： T - へ進む 

ぼくは右: r ， へ進んだ。 

洞窟は行きまりだった。 
rf くそ.::.に J 屯り; 1 AA / だ 


画面表爪例 

このような状態に陥ることを避けるため、ラベルの直後には必ず [ er 】 や [ cm 】[ ct 】 
などの文字消去タグを置 t 、てください。 

選択肢を3つ以上使いたい場合も同様で、 [ link ][ endlink ] で囲まれた選択肢と、 
ジャンプ先のラベルを増やすだけです。 
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•シナリオ例 

*bunki 

[er]¥ 

洞窟は右と左に分かれていた。 [1] 
「どっちへ行こうか」 [1] 


[link target=*scene001] 右手へ進む [endlink] 

[link target=*scene002 ] 左手へ進む [endlink] 

[link target=*scene003] その場に座り込む [endlink] 
[link target=*scene00 4 ] 声を上げて泣く [endlink] 
[link target=*scene00 5 ] 今来た道を戻る [endlink] 
[s] 


*scene001 

[er]¥ 

ぼくは右手へ進んだ。 [1] 
洞窟は行き止まりだった。 [1] 
ぼくはそこに座り込んだ。 [1] 
[s] 


*scene002 

[er]¥ 

ぼくは左手へ進んだ。 [1] 

外への出口が見えてきた。 [1] 
ぼくは思わず駆け出していた。 [1] 
[s] 


*scene003 

[er]¥ 

ぼくはその場に座り込んだ。 [1] 
もうどうなってもいいや。 [1] 
ts] 


*scene004 











遇択鼓とラベル 







_廳_讎 




[er]¥ 

ぼくは声を上げて泣いた。 [1] 
涙はしょっぱかった。 [1] 

[s] 


*scene005 

[er]¥ 

ぼくは今来た道を戻ることにした。 [1] 

しかし、背後からはあの怨霊が追いかけてくるはずだ c 
やっぱり戻れない！ [1] 
frump target 二 * bunkij ¥ 


[ 1 ] 


上の例では、「選択肢5」を選んだ場合のみ、もう一度選択肢を選び直させるた 
めに [ jump ] というタグを使っています。この [ jump 】 タグは、 [ link ][ endlink 】 とは違 
って、•プレイヤーが選択しなくても自動的に処理を指定のラベルに移す働きをもっ 
ています。 

•タグ K 述例 


[jump target=* どこかのラベル ]¥ 


[ jump ] タグは強制的に処理をジャンプさせるので、その下に書かれているシナリ 
才は [ jump ] より上に書かれたシナリオとは無関係になります。このため、慣れない 
うちは [ jump 】 の直後に [ s 】 を書いておくと「ああ、ここで処理の流れが止まってい 
るんだな」と理解しやすくなります。 
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ラベルと セーブ •ポイント 



吉里吉里/ KAG で制作したゲームにはメニューに「菜をたどる」「菜をはさむ」 
という2つのコマンドがありますが、これは一般に言われる「ロード」「セーブ」 
のことです。 

KAG で作られた作品でプレイ状況をセーブする場合、ユーザーは自由な場所で 
セーブすることはできません。セーブ可能な場所は KAG シナリオ上においてラべ 
ルが書かれている行のみです。 

さらに注意なのは、ラベル行にセーブ•タイトルが記述されていないとセーブで 
きないことです。 


•セーブできないラベルの例 

★start 
*opening 
★sceneOl 


•セーブできるラベルの例 

★start |スタート 
★opening | 才ー プニング 
*scene01| 出会い 


ラベルの後ろに半角の縦棒 （ 丨 ） を置き、その後ろにセーブ•タイトルを書い 
ておけば、プレイヤーはそのラベルでセーブできるようになります。 

セーブした場合、セーブ•タイトルは菜に表示されます。上の例では、 ラベル 
「★ opening 」 でセーブしたら菜には『オープニング』と表示され、 ラベル 「* scene 01」 
でセーブしたら菜には『出会い』と表示されます。 

選択肢を置く場合は必ずラベルを書かねばなりませんが、この場合、セーブ- 
タイトルは必須ではありません。そこでセーブさせたくないと思った場合は、セー 
ブ•タイトルを省略して純粋なラベルだけ書いておけばよいのです。 

この場合、プレイヤーが「栗を扶む」を使った場合、そこから一番近い過去に 
存在するセーブ•タイトルつきのラベルを通過した時の状態が、セーブデータとし 
て菜に保存されます。 

次の例を見てみましょう。 



半角の級棒 （ 丨 ） 
は キーボー ドでは 
Backspace キーの 
左にあります。こ 
の 記号は正式には 
「パイブライン」と 
呼びます。 


セーブ*タイト 
ルがあまり長いと， 
メニューが犓広に 
なってしまって使 
いにくくなります。 

セーブ • タイト 
ルには、短くて意 
味がよく分かって、 
ブレイ ヤーのゲー 
ム魂を刺激するよ 
うな粋な言葉を付 
けられたらいいで 
すね a 
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E 選択肢とラベル 

鬱 

» _泰參_ _ _タグ記述例 




[title name ="1999 ChristmasEve "] ¥ 

★ start 丨才ープニング 
[ er ]¥ 

ぼくは立花明。どこにでもいる普通の社会人。 [1] 

今日は12月24日0世間一般で言う、クリスマスイブ。 [1] 

イブの夜と聞いて、まず思いつくのは…… [1] 

ベイエリアの高層シティホテル。よく冷えたシャンパン。窓辺に飾った薔 
薇の花束。そして小さな箱に入ったクリスマスプレゼント。 [1] 

もしくは、小さなペンションホテル。お揃いのロシニョールのスキー板。 
暗い窓の外に舞う粉雪。そしてテーブルの上のキャンドルライト。 [1] 

え？その後……?|1] 

その後って……雑誌にはそれしか書いてなかったけど……？ [ p ] 

[ er ]¥ 

まあ、それはさておき、昨年のクリスマス。 [1] 

ぼくは、数年前からひそかに恋していた女性を豪華なディナーに誘うこと 
にしていた。 [1] 

女性の名は桐野由美香。 [1] 

勤め先は別だが、ぼくと同い年で、ちょっとしたきっかけで知り合ってか 
らはまるで兄弟のように仲のいい友達だ。 [1] 

友達という間柄に妙な恋愛感情が混入するとつきあい方がギクシャクして 
くる前例は数多いが、ぼく達の場合はそうではない。[1】 

ぼく自身は確かに由美香のことは好きだ。でも、それを簡単に口にできる 
ような男でもないし、言ったからどうなるとも思っていないのだ。 [1] 
「愛してるよ」…… [1] なんて、逆立ちしても無理だ。 [ p ] 

[ er ]¥ 

そんなこんなで、店の予約をしておきながらもぼくはなかなか本人を誘う 
ことができなかった。 [1] 

そして結論から言えば、ぼくはディナーの予約を恋人のいる友達に売りつ 
けてしまった。 [1] 

ぼくがやっと勇気を奮い起こして告げた時は、容姿端麗、明眸皓齒、才色 
兼備の由美香にはすでに先約が入っていたのだ。 [1] 

由美香はこんなふうに言っていた。 [1] 

「んもう、言い出すのが遅いわよ明。今年は友達とスキーに行くの。でも、 
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ラベルとセーブ • ポイント 


㈣ 


もし明さえよければ、来年のイブは今から空けておくわ」 [1] 

何とも気の長い話に聞こえるが、由美香の言葉としては別におかしくない。 
単純なぼくは、早速、一年先の計画を立て始めた。 [ p ] 

[ er ]¥ 

そしていよいよ、今年のクリスマスシーズン。 [1] 

旅行先については、昨年の冬に発売されたパソコンゲーム『かまいたちの 
聖夜』にあやかって長野県白馬村のペンションホテルに決めた。 [1] 

実はこのゲームにはいわくがある。 [1] 


この例では、途中に [ er 】 が3つ書かれていることから、文章は全部で4ページに 
渡って表示されます。 

たとえば、これをプレイしていて、最後の行の『実はこのゲームにはいわくがあ 
る』という文章を読んだところで莱を扶み、その菜を呼び出した場合、どこから 
ゲームが再開されるかというと、1ページ目の冒頭『ぼくは立花明。どこにでもい 
る . 』から始まります。 

つまり、 KAG の莱はいちばん最近に通過したラベルの位置を覚えていて、その 
時点でのデータをセーブするのです。 

それぞれのページ頭でセーブした t ゝ場合は、 [ er ]¥ の行の直前に以下のようなラ 
ベルを記述します。 


•タグ記述例 

★start |オープニング 
[ er ]¥ 

ぼくは立花明。どこにでもいる普通の社会人。 [1] 

* start 2 |才ープニング 
[ er ]¥ 

まあ、それはさておき、昨年のクリスマス。 [1] 

* start 3 丨オープニング 
[er ] ¥ 

そして結論から言えば、ぼくはディナーの予約を恋人のいる友達に売りつ 
けてしまった。 [1] 
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選択肢とラベル 



.'.へ':::':': '...八 


* start 4 |オープニング 
[ er ]¥ 

そしていよいよ、今年のクリスマスシーズン。 [1] 

このようにすベてのページにラベルを記述していくのは作業的に厳い、のですが、 
これ以外に、各ページでセーブさせる方法はありません。 

また、上記の例ではセーブ•タイトルがすべて『オープニング』になっています 
が、セーブ♦タイトルはラベルと違って重複可能です。もし、同じセーブ•タイト 
ルを記述するのが面倒な場合は、下記のように書きます。 

•タグ記述例 

★start |才ープニング 
* start 2 | 

* start 3| 

* start 4| 

ラベルの右側に「 | 」だけ書けば、その直前に通過したセーブ•タイトルが引 
き継がれます。直前が同様に「 I 」だけの場合は、さらに遡っていちばん近いセ 
ーブ•タイトルを保存します。 

また、ラベルの直後の行には [ er ][ cm ][ ct ] などの文字消去タグを必ず置くように 
します。この理由は、 KAG が菜に保存されたセーブ•データをロードするときに、 
必ず画面クリアを行なって、そこに書かれている文字をすべて消去してしまうから 
です。 

KAG では、画像レイヤーの状態、ロードされているファイルの情報、サウン 
ド • バッファやサウンド.ファイルの情報などは菜に保存しますが、メッセージ. 
レイヤーのどの位置にどの文字が表示されていたかという情報までは保存しません。 

このため菜をロー ドしたときには常に画面がクリアされるわけですから、その挙 
動と、普通に読み進めているときの状態を等しくしておく必要があり、このために 
ラベルの 直後ではメッセージ.レイヤーをリセットする [ er ][ ct 】[ cm ] タグを書く必要 
があるのです。 
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■メニューの作成例 


一例ですが、メニューを作るには以下のように書きます。 


•シナリオ例 

*start 

[position layer=messageO page=back frame ="" opacicy =200]¥ 
[playbgm storage :" test . mid "]¥ 

timage storage = M testOl . bmp " page=back layer = base ]¥ 
[current layer=messageO page = back ]¥ 

[locate y =260]¥ 

[ nowait ]¥ 

[style align = center ]¥ 

[link t arget =* opening ] ゲームをはじめる [ endlink ] 

[link target =* dataload ] セーブデータを ロー ドする [ endlink ] 

[link targe t = * op t ion ] オプション [ endlink ] 

[link target =* end ] ゲー厶を終了する [ endlink ] ¥ 

Lstyle align=defau 丄 t ]¥ 

[ endnowait ]¥ 

[trans method=crossfade time =2000]¥ 

[ wt ]¥ 

[current layer=messageO page = fore ]¥ 

[ s ] 


*opening 
[cm] ¥ 

オープニング。 [1] 
[s] 


*dataload 
[cm] ¥ 

データロー ド。 [1] 
[s] 



option 
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選択肢とラベル 


[cm] ¥ 

オプション。 [1] 


*end 
[cm] ¥ 

エンド。 [1] 

[s] 


[ position ] タグは、以前メッセージ.レイヤーの位置やサイズを変更するときに説 
明しましたが、ここでは画像枠や透明度などの属性を指定するために利用します。 


吉里吉至 


システム⑤文字表示 (s) 罙統どる <i) 粲をは?む勉通凾切ヘルプ妙デバッグ必 





ゲームをはじめる 
セーゾデ' —夕を n — ドする 
オプション 
ゲ'ームを終 r する 




画面例 


•タグ記述例 

[position layer=messageO page = rore f rame= ’’ waku . png 
opacity=255] ¥ 
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5-2 ラベルと セーブ •ポイント 

ぐ: 人..: v . へ. レ.'::..: た パン; r ゲ:ン ぐ:く 「 バ 

殲參_罄 


frame 属性は、メッセージ*レイヤーに画像枠を使いたい場合にファイル名を指 
定する属性です。画像枠が不要な場合は 「 frame = "叫のように記述します。下の 
画面例では、画面下部に「メッセージ.レイヤー0」がメッセージ枠と一緒に表示 
されています。 



メツセージ枠を使つた画面例 


opacity 属性は、メッセージ • レイヤーの濃度を指定する属性で、「255」のとき 
は完全な可視状態で、「0」にすると完全に透明になります。シナリオの画面例で 
は 「 opacity =200」 ですが、上の画像枠を使った画面例では「100」にしてあります^ 




シナリオ例の5、17行目にある [ current ] タグは初めてだと思いますが、これは、 
文字を表記するためのメッセージ.レイヤーや、その裏表を指定するためのタグです。 

•タグ記述例 

[current layer=messageO page=back] ¥ 

Lcurrent JLayer=message 〇 page=rore]¥ 

[current 丄 ayer 二 message1 page 二 fore]¥ 














遇択彼とラベル 

ここでは、メッセージ.レイヤー0のバックグラウンドに文字を表示し、背景画 
像と一緒にトランジションで表へ表示するために利用しています。トランジション 
が終了したら、きちんとメッセージ • レイヤー0のフォアグラウンドに戻しておき 
ます。 


選択肢として存在する4つの [ Unknendlink ] 部分に全角のスペースが記述されて 
いますが、これはマウス • カーソルが乗ったりカーソル • キーで選択されたときに 
表示される矩形の大きさを揃えるためです。ただし、この方法は、デフォルト•フ 
ォントがプロポーショナル*ではなく等幅フォント * の場合のみ利用できます。 

また、 [ link ][ endlinkl の最後の行の行末に半角の「¥」が置かれているのは、も 
しこの「¥」がないと、改行扱いになってしまって、次のページに進むためのクリ 
ック待ち記号が表示されてしまうからです。これは文字列が画面の下端に到達し 
たことが原因ですが、メニューが改ページしてしまうのは避けなければならないの 
で、最後の行に改行を中止する「¥」を置くことで回避しています。 








ただ読ませるだけの電子小説を作ることに飽きた 
5、バラメータによる分岐処理、乱数、フラグに 
よるイベント管理など、変数を利用してプレイヤ 
一があっと驚く作品を作ってみましよう。ここでは 
変数の基本的な取り扱いについて解説します。 
















変数は「何かを 
入れておく入れ物」 
のことです。 

中学の数学で学 
ぶ x や a などがこれ 
に当たります。 
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KAG で取り扱える変数の形式 


ゲームの主人公の名前などをプレイヤーに入力してもらうためには、変数を 
利用します。 

KAG では、「数値変数」「文字変数」「フラグ」に区別はなく、すべて同一 
のものとして扱うことができます。このために変数に数値を代入すれば「数値 
変数」として、文字を代入すれば「文字変数」として、「〇」か「1」を代入す 
れば「フラグ」として利用することができます。 

《変数の名前のルール》 

変数を使いたい場合、まずは変数に名前をつけますが、このとき、以下の 
ような ルールを 守ります。 

• 半角英数と全角文字のみ利用可 
•記号は「」（アンダーバー）のみ利用可 

-ゲーム変数の名前は 「 f .」、 システム変数の名前は 「 sfj で始める 
-変数名の先頭に数字を使ってはいけない 

•予約語は使ってはいけない_ — 

•予約語の例 


count assign save load finalize invalidate instanceof 
continue function debugger property default extends 
finally isvalia typeof delete return export import switch 
global setter getter break false super catch class while 
throw const enum this void true null with else case for 
new var try in if do 


これらの単語は TJS 内で予約されているため、変数として使うことができま 
せん。たとえば、 「 f . count 」 や 「 sf . assign 」 という変数名は使えないので、注 
意してください。 
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《ゲーム変数とシステム変数の違い》 

「ゲーム変数」はゲーム.シナリオ内での処理に利用し、「システム変数」 
はゲームのシナリオを離れたシナリオの外で利用します。 

ゲーム変数は個々のセーブ•データに記録されるため、「吉里吉里」を再起 
動した場合は読み込まれません。このため「見たエンディング/見ていないエ 
ンディング」などを表わす変数データは保持することができません。 

システム変数は r 吉里吉里」を再起動したときに真っ先に読み込まれるフ 
ァイル内部に記録されているため、どのセーブ•データをロードしても、最初 
からプレイをやり直しても、最後に代入された値が常に保持されます。 

ゲーム内の処理をするときに「ゲーム変数」を用い、シナリオ外のシステム 
的な処理に「システム変数」を使うことを覚えておいてください。 

•変数例 

f . okane f .hitpomt f .magicpomt f . koukando f .pastime 
sf . endingOl sf .name sf .pictureshow sf.wdee など 


■変数を使った名前入力 


ここでは、「あなたの名前を入力してください」と促すダイアログを開き、 
入力してもらった文字列を変数に格納して表示してみます。 



名前を入れておくための文字変数は「 f . namej にしたいところですが、苗字 
と名前を別々の変数に格納したいので、 「 f . sname 」「[ name 」 と2つ準備します。 

続いて、画面に入カウインドウを表示してプレイヤーに名前を入力させます 
が、ここで利用するのは [ input ] タグです。 


•タグ記述例 

j [input name = f.sname prompt = "あなたの苗字は？" title = "苗字の入 
| 力"]¥ 

I [ input name=f .name proiupt =” あなたの名前は？” title = "名前の入 
I 力"] ¥ 
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雜の利用 
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KAG シナリオ内 
で文字列を指定す 
る場合は必ずシン 
グル•クオーテー 
シヨンい）で文字 
列をくくる癖をつ 
けてください。 


「 name 属性」は入力文字列や数値を格納するための変数名で、 「 prompt 属 
性」は入カダイアログの内部に表示されるメッセージ、 「 title 属性」はダイア 
ログの左上のタイトルに表示するメッセージをそれぞれ指定します。 

また、変数の内容をシナリオ内で表示するには、 [ emb ] タグを使います。 

•タグ配逋例 

[emb exp=f.snamel] 


•シナ U 才例 

^mputname 

[er]¥ 

あなたの名前を教えてください。 [1] 

[input name=f. sname prompt=" あなたの苗字は ？’ 1 title=” 苗字の入力 "]¥ 
[input name=f.name prompt=” あなたの名前は ？" title= n 名前の入力 ”] ¥ 
あなたの名前は [font color=0xf f f f 00 ] [emb exp 二 f . sname] [emb 
exp=f .name] [resetf ont ] でですか？ 

[link target=*ok] いい [endlink] 

L 丄 ink target=*inputname] 7 こめ [endlink]¥ 

[s] 


上の例では、何も文字が入力されていない状態でエンター • キーや OK ボタ 
ンを押した場合、変数が空の状態でシナリオが進んでしまいます。このため、 
入カダイアログを表示する前に最初からサンプルの文字列を変数に代入して お 
けば、名前が空白のままでシナリオが始まるというトラブルが起きません。 


変数に数値や文字などの値を恣意的に代入するには [ eval ] タグを使います。 


•タグ記述例 

[eval exp= H f .sname= • P I A r "]¥ 
[eval exp 二 •• f . name= ，少尉 • ■• ] ¥ 


これで 「 f . sname 」 には 「P I A 」 という文字列が、 「 f . name 」 には「少尉」 
という文字列が入りました。 


爾隱_______ 
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■変数内容の評価による条件分岐 


長い名前や、使ってほしくない名前を使われた場合の他に、何も入力しな 
かったり、入力されていたサンプルを消してしまった場合、これらの変数内容 
を評価し、必要なら再入力させることができます。 

これらは条件分岐なので、 [if] タグを用います。 [if] タグは必ず [endif] とペア 
で使います。 


まずは変数 [name に入力された名前が『少尉』のときは入力をやり直させ 
るシナリオ例です。 

•シナリオ例 

★inputname 

[er]¥ 

あなたの名前を教えてくださぃ。 [1] 

[input name=f.name prompt= H あなたの名前は ？ 11 title= " 名前の入力 '’]¥ 
[if exp=" f • name==' 少尉 1 " ]¥ 

[jump target 二 * inputname_02]¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp 二 f .name] [resetfont] 
でぃぃですか？ 

[link taxget 二 * ok] いし、 [endlink] 

[link target 二 * inputname] だめ [endlink]¥ 


この場合、 「f.name」 という名前の変数に「少尉」という文字列が入力され 
ている場合は [if][endif] の間が実行されます。つまり [jump] タグによるラベル 
ジャンプが行なわれるわけです。 

次に、変数 rinamej の内容が空の場合に入力をやり直させるシナリオ例 
です。 


変数の利用 


暴錐癱癱_ # _ 



[け】による条件分 
岐において前後が 
等しい場合はイコ 
ールは2つ必要で 
す。これを1つし 
か害かないと意図 
した処理ができま 
せん。このときエ 
ラーは返らないの 
で、注意してくだ 
さい0 

条件分岐の詳細 
については「数値 
変数」の項で詳し 
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の利用 

纖徵鐵職^^®^®署^^^^^^^^ 1 

# 



籲シナ リオ例 __ 

*inputnarae 
[er ] ¥ 

あなたの名前を教えてくださぃ。 [1] 

[input name=f.name prompt= " あなたの名利は ？ 1 ’ title=" 名刖の入力 ”]¥ 
[if exp="f♦name==' ’"]¥ 

[jump target=*inputname—02]¥ 

[endif]¥ 

あなたの名前は [font color=0xffffOO] [emb exp=f .name] [resetfont] 
でぃぃですか？ 

[link target=*ok] いい [endlink] 

[link target=*inputname_02] だめ [endlink]¥ 

[ s ] 

シングル•クオーテーションを 2 つ並べて記述すると、「空」の意味になります。 
また、これらの2つの条件分岐を1つにまとめることもできます。 

•シナリオ例 

*inputname 
[er]¥ 

あなたの名前を教えてぐださぃ。 [1] 

[input name=f .name prompt: 1 ’ あなたの名前は ？" title=" 名前の入力 "]¥ 
[if exp=" f .name== 1 少尉 '| | f.name== ， • " ]¥ 

[: jump target=*inputname—02]¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp=f • name] [resetfont] 
でぃぃですか？ 

[link target 二 * ok] し、し、 [endlink] 

[link target=*inputname_02] だめ [endlink]¥ 

[ s ] _ — — 

半角の「丨」を2つ続けて記述すると、 「 OR 」 の意味になり、どちらかの条件を 
満たしてぃれば 「 exp 」 による評価式が“真”になります。3つ以上の条件を処理 
したぃ場合も、同様に評価式を延長して記述することによって処理できます。 









6-1 変数の利用 



•記述例 

[if exp=" f • name== 1 少尉 1 | | f • name== 1 1 | | f .name ， Dee 1 | | f .name 

•でい一•时 ]¥ 


長すぎる名前を受け付けなくするには、文字変数に入力された文字列が何 
文字かを調べ、それを評価する式を作って入力制限を行ないます。 

変数に格納されている文字の長さを調べるには、変数の直後に 「. length 」 
と書きます。 

•記述例 

f.name.length 


•シナリオ例 

*inputname 
[er]¥ 

あなたの名前を教えてください。 [1] 

[input name=f .name prompt:” あなたの名前は ？' ' title: 名前の入力 "]¥ 
[if exp="f.name.length>3||f.name==''"]¥ 

名前は 1 から 3 文字までです。 [1] 

再入力してください。 [1] 

[]ump target=* mputname_03 ] ¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp=f .name] [resetfont] 
でいいですか？ 

[link target=*ok] [endlink] 

[link target=*inputname_03 ] だめ [endlink] ¥ 
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利用 

凝''：:': v . t ; が〜ヴ 

• •#•••• 入力された文字が、ある特定のキーワードを含んでいるかどうかを調べる場 



合は、 r . indexOfJ を用います。 

「 indexOf 」 は、「 A . indexOfCBi )」 の記述形式をとり、文字列 A の中で文字列 
B が現われる位置を調べます。文字列 A の先頭に文字列 B があれば返り値は 
「0」になり、文字列 A の2文字目に文字列 B があれば返り値は「1」になります。 

文字列 A の中に文字列 B が見付からない場合は返り値は「-1」になるので、 
これを評価することで、文字列 A の中に文字列 B が含まれているかを調べるこ 
とができます。 

•記述例 

*mputname 

ter]¥ 

あなたの名前を教えてください。 [1] 

[input name=f.name prompt: " あなたの名前は ？" title= " 名前の入力 "]¥ 
[if exp=" f . name • indexOf (' はか ， ） ! =-1" ]¥ 

悪口は言わないで、ちゃんとした名前を入力してください。 [1] 

[jump target=*inputname_04] ¥ 
tendif]¥ 

あなたの名前は [font color=0xffffOO][emb exp=f.name][resetfont] 
でいいですか？ 

[link target 二 * ok] いい [endlink] 

[link target=*inputname—04] だめ [endlink]¥ 


上記の例では、 「 f . name 」 という変数に「ばか」という文字列があるかどうかを調 
ベています。もし 「 f . name 」 の中に「ばかじゃん」や「大ばか」、「かばかば」など、「ば 
か」という文字列が使われていた場合は 「 indexOf 」 への返り値は「-1」以外にな 
り、 [ if ] タグで定義された条件を満たすので、2行目のメッセージが表示されます。 
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■数値変数のフラグ利用 


続いて数値変数の利用ですが、数値変数は大きく分けて「数値変数」と 
「フラグ」の2種類の使い方ができます。 

まずは「フラグ」ですが、市販のゲームではプレイヤーが何かのアクション 
を行なった場合にスイッチを ON にし、後の条件分岐の時にスイッチの状態に 
よって分岐先を 決定す ることが多々あります。このスイッチのことを 「フラ 
グ」と呼びます。 

籲シナ I ；才例 

★sceneOl | 旅人 
[ct]¥ 

旅人が食料をめぐんでくれと言っています。どうしますか？ [1] 

[link target=*scene02] めぐんでやる [endlink] 

[link target=*scene03] めぐんでやらない [endlink] 

[s] 


*scene02 |めぐむ 
[ct]¥ 

ぼくは旅人に食料を少し分けてやった。 [1] 

「あんたは優しい人だな。よし、一ついいことを教えてやろう」 [1] 

旅人はぼくが渡したパンを食べながら話し出した。 

「あの洞窟の床には、ーヶ所だけ石床が外れる場所がある。その下に宝が埋 
まっているって話だ。ま、俺は怪物に食い殺されるのは嫌だから行かないが、 
腕に自身があるなら行ってみたらどうだい？」 [1] 

[eval exp="f.hint=l"]¥ 

[jump target=*scene04]¥ 

[s] 


*scene03 | めぐまない 
[ct]¥ 

ぼくは旅人を無視することにした。 [1] 











変败の利用 

總餐纖溝觀竞魏露獨娜穩威嘯™ 



これから洞窟へ入らねばならないのだから。 [1] 
[eval exp="f.hint=0"] ¥ 

[jump target=*scene04]¥ 

[s] 


*scene04| 洞窟 
[ct]¥ 

ぼくは洞窟へ入っていった。 [1] 

[if exp="f•hint==l”][jump target=*scene04b][endif]¥ 
だが、洞窟には何もなかった。 [P] 

[s] 


*scene04b 

しばらく歩いたところで、ぼくは先ほどの旅人の話を思い出し、床石を調 
ベてみることにした。 [1] 

なるほど、確かにーヶ所だけ外れそうな床石がある。 [1] 

」 s] _ _ 

旅人に食料をめぐむと、 rihintj という変数の値が「 1 」になります。これ 
は、「旅人に洞窟の宝の話を聞いた」というフラグが ON になったことを意味 
します。これらを利用すれば、後に [if] タグで条件分岐を行なうときに、プレ 
イヤーのプレイ状態に従ってシナリオを分岐できるわけです。 

また、選択肢を選んだ時点でフラグの状態を変化させることもできます。こ 
の場合は、 [link 】 タグに exp 属性を記述します。 

籲シナ U 才例 

★sceneOl | 旅人 
[ct]¥ 

旅人が食料をめぐんでくれと言っています。 [1] 

どうしますか？ [1] 

[link target=*scene02 exp=" f • hint=l __ ] めぐんでやる [endlink] ¥ 
[link target=*scene0 3 exp= " f • hint = 0 "] めぐんでやらない 
[endlink]¥ 

[s] * 








KAG の場合、変数を [ eval ] で指定しなければ、その変数は未定義の状態で 
扱われます。つまり、「0」の値を代入したい場合は、以下の記述例のように 
何も書かなくてもかまわないのです。 

•シナ才例 _ 

★scene01| 旅人 
[ct]¥ 

旅人が食料をめぐんでくれと言っています。 [1] 

どうしますか？ [1] 

[link target 二 * scene02 exp=" f . ： hint=l ， ' ] めぐんでやる [endlink] ¥ 
[link target 二 * scene03"] めぐんでやらない [endlink]¥ 

[s] 


このように変数に値が入る方のみ記述しておけば、後に [ if ] タグで条件分岐させ 
た場合に、 「 f . button 」 が未定義の場合は「値=0」として利用できるわけです。 


■数値変数の演算と条件分岐 


KAG で一度定義した変数の内容は、シナリオ内で意図的に消去することが 
ない限り、シナリオ実行中はずっと保持されます。 

たとえば、主人公のライフ • ポイン トのように、 ゲー 厶 • スター ト 時には 
「10」で、罠にはまると減り、薬を飲むと回復するような値を管理するために 
使えます。 

•タグ記逑例 


初期殷定 

[eval exp="f.lp=10"] ¥ 

現在の傭に 3 を追加 

[eval exp= n f.lp=f.lp+3 M ]¥ 

驗の値から 3 を減 

[eval exp= ，， f.lp=f.lp-3"]¥ 

現在の値の 3 倍 

[eval exp="f.lp=f.lp*3"]¥ 

現在の値の 3 分の 1 

[eval exp= •• f •lp='~ (f •lp/3)’’] ¥ 


初期設定だけは 「 f . lp 」 に「10」という整数を代入していますが、それ以降 
はすべてイコールの右にも左にも 「 f . lp 」 が記述されていて、ちょっと変な式 
に見えますよね。これは、数学的に考えるとおかしいのですが「イコールの右 
側の値をイコールの左側の変数に代入する」という意味で、プログラムでは多 
く利用されている表記方法なのです。 
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ですから [eval exp= n llp=llp+3 M ] という式は、「現在の “f.lp” （右側）に “3” 
をプラスして、それを新しい “f.lp” （左側）の値として保管しなさい」という 
意味になります。割り算の部分だけは「一」（チルダ）とカツコが書かれてい 
ますが、これは割り算の値が整数以外になってしまった場合に、商を切り捨て 
て整数化するためのものです。また、割り算で商ではなく余りを得たい場合 
は、半角スラッシュではなく、以下のように半角の「％」を使います。 


•タグ IB 迹例 








. i 鷄讎_纖_麟》觀_讓纖騰觀麵 


: __ m 綱__議_隐__ 


数酸数| 


変数を複数使った処理を行なう場合は、このように変数の覚書を作ってお 
くとよいでしょう。 

続いて、変数の内容による条件分岐ですが、以下の例のように記述するこ 
とによって [ if 】 タグでその後の処理を分岐させることができます。 

まずは変数 「 f . okane 」 の値が500以下の場合のみお金を500もらえる条件分 
岐のシナリオ例です。 

•シナ U 才例 

[if exp 二 ， , f •okane<=500"]¥ 

[eval exp="f.okane=f.okane+500"]¥ 

[endif]¥ 

続いて、変数 riokanej の値が 500 以下の場合のみお金を 500 もらい、合計 
金額が10000を超えた場合は全部奪われてしまう条件分岐のシナリオ例です。 

•シナリオ例 

[if exp=" f • okane< = 500•，] ¥ 

[eval exp="f•okane=f.okane+500"]¥ 

[if exp="f.okane>10000]¥ 

[eval exp="f•okane=0"]¥ 

[endif]¥ 

[endif]¥ 

最後に、変数 「 f . okane 」 の値が 500 以下の場合のみ、現在のお金を2倍に 
してもらい、さらに1000もらえるというシナリオ例です。 

•シナリオ例 

「 [if exp 二 " f • okane<=500 ’’ ] ¥ 

[eval exp= M f.okane=f•okane*2+1000"]¥ 

[endif]¥ 
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[ if ] タグの復習になりますが、このタグの exp 属性で行なっていることは、 
「変数と文字」、または「変数と数値」、または「変数と変数」の照合です。も 
しこの照合結果が『一致』（つまり真）である場合は、 [ if ! タグと [ endif ] タグ 
の間にあるタグが実行されたり、文章が表示されたりし、照合結果が『不一 
致』（つまり偽）の場合は、タグと [ endif 】 タグの間の行は無視されます。 


[if ex P = "変数や定数等号不等号変数や定数 
(条件に一致している場合の処理） 


[ endif ] ¥ 


[if exp = "変数や定数等号不等号変数や定数"](条件に一致している 
場合の処理） [ endif ] ¥ 


変数や定数を書く場合ですが、数値や変数の場合はそのまま記述できます。 

•記删 


文字列の場合は、ダブル，クオーテーション（”）でく くります, 

•記述例 



前と後ろが等しい 

>* 

前が後ろ以上 

> 

前が後ろより大きい 

< 二 

前が後ろ以下 

< 

前が後ろより小さい 


前と後ろが異なる 


— • 110 











6-3 


乱数の利用 




%数の利用 



「じゃんけんゲーム」や「ルーレット」などは、こちらが意図した結果をコンピュ 
一夕が出してこない点が面白いのですが、これらを実現するためには、「乱数•」を 
使います。 

KAG では、乱数を発生させるジェネレータとして 「 random 」 と 「 intran - 
dom 」 というものが準備されており、 「 random 」 は0以上1未満の実数•を、 
rintrandomj は指定値以上、指定値以下の整数*の乱数を生成します 。 KAG 
を利用してゲームを作る場合は、 「 intrandom 」 の方を利用します c , 

•記述例 

[eval exp=" f • ransuu= mtrandom (1,100) " ] ¥ 


上の例では 「 transuu 」 という変数に「1」から「100」のいずれかが代入されます。 


•シナ IJ 才例 _ 

*start 

[er]¥ 

さいころ勝負！ [1] 

[eval exp=" f.dice_player=intrandom(1,6) " ]¥ 

[eval exp=" f . dice_com= intrandom (1,6) w ] ¥ 

コンピューターの 目： [emb exp= n f * dice_com"] 

プレイヤーの目 ： [emb exp= 11 f . dice_player"] 

[if exp= ” f . dice_com>f • dice 一： player"] コンピュータの勝ち！ 
[r][endif]¥ 

[if exp= " f . dice—com< f • dice_player"] プレイヤーの勝ち ！ 
[r][endif]¥ 

[if exp="f .dice_coin==f .dice^player'*] 弓 i さ分け！ [r] [endif]¥ 
[link target=*start ] もラー度やる [endlink] ¥ 


さいころの目は1から6までなので 「 intrandom ( l ,6)」 という記述を行ない、 
それを [ eval ] タグを用いて 「 f . dice _ player 」 と 「 f . dice _ com 」 という変数にそれ 
ぞれ代入しています。あとはそれらを [ emb ] タグで表示し、 [ if ] で双方の値を比 
較してメ ッ セージを表示します。 




♦乱敷 

でたらめな數儀 [ 


* 実数 

讓差を含む霰。小数点の 

ついた数。 

♦螯 tt 

0と自然数、逆自然数。 
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数讎変数畑團败> サブル-チン化 


"::::く 
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ゲームを作っていると、定期的に変数の処理を行なわねばならないような場 
面に出くわす場合があります。 

例として、拙作 ri 999 ChristmasEveJ の第二話に厳冬の森の中を歩くシー 
ンがありますが、ここでは別のラベルに進むごとに時間が5分経過し、どこを 
どう歩いても120分を過ぎると自動的に凍死するシーンへジャンプする処理を 
しています。 

シーンは全部で50近くもあるので、各ラベルの冒頭に数値変数の処理をす 
るためのシナリオを書 t ゝていたのでは後で修正するときにも面倒ですし、何よ 
りシナリオが汚くなってしまうので、サブルーチンを使っています。 

「サブルーチン*」は、定型処理をするシナリオ部を一つだけ作っておき、 
必要に応じてそこにアクセスして処理を行なうことができるもので、これを呼 
び出すには [ call 】 タグを、戻る場合は [ return ] タグを使 t ゝます。 


•タグ記述例_ 

[call storage=" フアイル名 -ks" target=* ラベル名 ]¥ 
[return] ¥ 

[return storage= •• ファイル名 .ks" target= ★ ラベル名 ]¥ 



籲シナリオ例 

*chapter2_scene04b | 第二話出発 
[eval exp="f.spendtime=0"]¥ 
[eval exp="f.limittime=120 M ]¥ 
[er]¥ 

(前略） 

「さあ行こう！由美香！」 [1] 

「ど つちへ . ？」 [P] 
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ぼくは、 

[delay speed=nowait][locate y=355]¥ 

[link target=*chapter2_scene06] A. 北の道を選んだ [endlink] 
[link target=*chapter2_scene09] B. 南の道を選んだ [endlink] 
[link target=*chapter2_scene05] C. 西側の雑木林に踏み入った 
[endlink]¥ 

[delay speed=user]¥ 

[s] 


★chapter2_scene05 | 第二話西の雑木林 
[call target=*chapter2 一 timechecker] ¥ 
ぼく達は雑木林の中に踏み入った。 [11 
外から見ただけではわからなかったが、 
立ち枯れた木が至るところに転がっており、 
とてもではないが歩けそうになかった。 [1] 
「無理だ、戻ろう」 [1] 


無言の由美香を連れて林を出たぼくは、 

もう一度憤重に行く先を検討することにした。 [1] 

ぼくは、 

[ae 丄 ay speed=nowait][locate y=375] ¥ 

[link target 二 * chapter2—scene06] A. 北の道を選んだ [endlink] 
[link target=*chapter2_scene09] B. 南の道を選んだ [endlink]¥ 
[delay speed=user]¥ 


★chapter2_scene06 | 第二話教会は西 
[call target=*chapter2_timechecker] ¥ 

五分ほど歩いたところで道が分かれていた。 [1] 

西に向かう道、北に向かう道、南に向かう道の三叉路だ。 [1] 
「教会は西よ……」 [1] 

背後の由美香がぼんやりと言う。 [1] 
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ぼくは、 

[delay speed=nowait][locate y=355]¥ 

[link target=*chapter2_scenel2] A . 西の道を選んた [endlink] 

[link target= : *chapter2_scene07] B . 北の道を選んた [endlink] 
[link target=*chapter2_scenel4] C . 南の道を選んた [endlink]¥ 
[delay speed=user]¥ 



★chapter2_scene0 7 丨第二話違う気がする 
[call target=*chapter2_timechecker] ¥ 

五分ほど歩いたところで道が分かれていた。 [1] 

西に向かう道、北に向かう道、南に向かう道の三叉路だ。 [1] 
「違うような気がする……」 

背後の由美香が言う。 [1] 


ぼくは、 

[delay speea=nowait][locate y=3b5] ¥ 

[link target 二 *chapter2 一 scenell] A . 西の道を選んだ [endlink] 
[link target=*chapter2_scene08] B . 北の道を選んだ [endlink] 
[link target=*chapter2_scene06] C. 南の道を選んだ [endlink]¥ 
[delay speed=user]¥ 



*chapter2 一 timechecker 

[eval exp="f.spendtime=f.spendtime+5"]¥ 

[if exp= M f. spendtime>f.limit time] [return target : ★凍死シー 
ン ] [endif]¥ 

[er]¥ 

[emb exp=”f • spendtime"] 分経過 / [emb exp=" f •limit time "] 分 

[ 1 ] 

[return] 
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•変数覚書 


pspendtime | 

経過時間 

初期値は0 


限界時間 

初期値は120 


シナリオ例の最初と最後を除く各シーンの冒頭にある [call target =* chap - 
ter 2_ timechecker ] で、それぞれの場所から 「* chapter 2_ timechecker 」 という 
サブルーチンを呼び出して処理をし、終わったら元の場所に戻っています。 

サブルーチン 部である r * chapter 2_ timecheckerj については、通常の ラべ 
ル 付きシナリオと同じ扱いで、特に「ここが サブルーチン だよ！」と宣言する 
必要はありませんが、利用する上でいくつかの注意点があります。 

① まず、サブルーチン部は [ call ] タグでのみアクセスできる場所に書くべき 
です。 KAG のシナリオは上から下に向かって順番にタグを実行するので、気 
がついたらサブルーチン部も実行されてしまう場合があります。 

このような状態を避けるには、サブルーチンの前で [ s ] と [ jump 】 を使い、サ 
ブルーチン部をジャンプして避けるか、サブルーチンは別のファイルにして 
[call storage = "ファイル名. ks ” target =* ラベル]で呼び出すようにします。 

② もうひとつは、サブルーチンのラベルにセーブ•タイトルを記述してはい 
けません。サブルーチンは本来見えない処理をする部分のはずですから、そこ 
でセーブされてしまった場合、ロードをした時に予期せぬ状態からゲームが始 
まることになるからです。 

さらに、サブルーチンとして記述したラベルの行末には必ず [ return ] タグが 
ないといけません。このタグはサブルーチン.ラベルをコールした部分の直後 
に戻るという大切な働きをしているからです。 

シナリオ例ではよく見ると 「 return 」 が二つありますが、中ほどの [ return ] 
は、経過時間が限界時間を超えた場合に凍死シーンへジャンプするためのも 
の、下の方の [ return ] はサブルーチン処理を終えてもとの場所に戻るためのも 
のです。 

中ほどの [ return ] については代わりに [ jump ] タグを使いたくなりますが、サ 
ブルーチン 内部での ジャンプ はすべ て [ return ] タ グで行わないと、 コールスタ 
ックと呼ばれる値が不正になり、結果として KAG が正常動作しなくなる場合 
があります。 



1 999 Christmas - 
Eve の例では、サブ 
ルーチン内に [ er ] 夕 
グを書いておいた 
ため、それぞれの 
ラベルの次行にい 
ちいち [ er ]¥ を置く 
必要がなくなりまし 
た。 

このように、ま 
とめられるものは 
極力まとめていく 
ことが、きれいな 
シナリオを害く秘 

訣になります。 

V ... 
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変数の利用 



変数や乱数を上手に利用すると、面白いイベントが作れます。 


ここでは、3つの扉があり、どれか1つにはお化けがひそんでいるイベント 
を作ってみます。お化けの隠れている扉は、乱数を利用してシナリオを実行す 
るたびにランダムに変わるようにします。 

①使5変数 



mm 

f.doorl 

扉 1 を開けたかどうか 

0 

f . door 2 

扉2を開けたかどうか 

0 

f . door 3 

扉3を開けたかどうか 

0 

f.fear 

お化けがひそむ扉 （1 〜3でランダム） 



•記逋例 — 

[eval exp="f.doorl=0"]¥ 

[eval exp="f.door2=0"]¥ 

[eval exp="f.door3=0"]¥ 

[eval exp="f.fear=intrandom(1,3)"]¥ 


② 変数の変 1 匕 

扉を一度開けたら変数の値を「 1 」にして、次からは選べないようにする。 

[eval exp="f.doorl=l"]¥ 

[eval exp=" f. door2=l ，， ]¥ 

[eval exp="f.door3 =1"]¥ 

③ 変数の値による分岐処理 

変数 「 f.door* 」 の値が「 1 」の時はすでに一度開けているため、次からは選 
択肢を表示しないようにする。ここでは 「 f.door* 」 の値が「 0 」の時のみ選択 

肢を表示するように指定 0 _ 

[if exp=" f . doorl==0 "][link target=*doorl] 右の扉 [endlink] 

[r][endif]¥ 

[if exp=" f .door2 = = 0 H ][link target=*door2 ] 真中の扉 [endlink] 
[r][endif]¥ 
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[if exp=__f .door3==0__] [link target=*door3 ] 左の扉 [endlink] 
[r][endif]¥ 


④お化け登壩 

乱数で得られた番号の扉を開けた時、恐怖が飛び出す。 
*doorl 
I [er]¥ 

[if exp=_’f .fear==l"] [jump target=* 恐怖 ] [endif ] ¥ 

*door2 

[er]¥ 

[if exp= H f .fear==2" ] [jump target: ★ 恐怖 ] [endif] ¥ 

*door3 

[er]¥ 

[if exp=" f • fear==3 ._ ] [ jump target= ★ 恐怖 ] [endif ] ¥ 


•シナ u 才記述例 

★start 

，•変数の初期設定 

[eval exp="f.door 1=0 __] ¥ 

[eval exp= __ f • door2=0 ” ] ¥ 

[eval exp="f.door3=0"]¥ 

[eval exp 二 " f•fear=intrandom(1,3)"]¥ 

7 

*select 

[er]¥ 

どれを開ける？ [1] 

[nowait ]¥ 

[if exp=f • door 1==0__][link target=*doorl] 右の屝 [endlink] 
[r][endif]¥ 

[if exp= M f.door2==0 H ][link target:*door2 ] 真中の屝 [endlink] 
[r][endif]¥ 
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[if exp 二， ’ f.door3 = 

[r] [endif]¥ 
[endnowait]¥ 

[s] 


1 




=0"] [link target=*door3] 左の屝 [endlink] 


*doorl 

[er]¥ 

[if exp 二 " f • fear ==1 ”][jump target 二*恐怖 1[endif]¥ 
なにもない。 [1] 

[eval exp 二，， f • doorl=l"]¥ 

[jump target=*select]¥ 

[s] 

/ 一 

*door2 

[er]¥ 

[if exp 二 ,, f • fear==2 M ] [ jump target =* 恐怖 ] [endif]¥ 
なにもない。 [1] 

[eval exp= M f.door2 = l"]¥ 

[jump target 二 * select]¥ 

[s] 

t . ^ 

*door3, 

[er]¥ 

[if exp=" f. fear==3 " ] [jump target= ★ 恐怖 ] [endif]¥ 
なにもない。 [1] 

[eval exp="f.door3 =1"]¥ 

[jump target=*select]¥ 

[s] 

f ' 

★恐怖 

[er]¥ 

「きゃあああああああああああああああ！」 [1] 

(恐怖の絵を見せてやってください） [1] 

[s] 
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KAG のシナリオは、書けば書くほどゴチヤゴチヤ 
してきますが、そんな時に便利な機能として準備 
されているのが「マクロ定義機能 J です。ここでは 
マク□の基本的な取り扱し、について解説します。 














Step 


マク〇を活用する 





KAG の「マクロ」とは、複数のタグを一つのタグにまとめて自由に定義で 
きる機能のことです。たとえば、以下のようなトランジシヨン命令をシナリオ 
内に記述したとします。 


[trans time=2000 rule 二 ， • transl.png" vague=100]¥ 

L[wt]¥ ___ 

これがーヶ所だけならいいのですが、シナリオ中に 100 も 200 も出てくる場 
合に、そのたびに 2 行のタグ命令を記述するのは面倒です。 

「コピー すればいいじゃん」と思うかもしれませんが、後から rule ファイル 
を全部別のものに変更したいと思ったり、トランジション • タイムを変更した 
いと思った時には、記述されたタグを全て修正しなければなりません。 

[エディタで 一括置換をすれば一発じゃないか」と言う人は、シナリオ•フ 
ァイルが 100 も 200 もあった場合はどうしますか？ 

このような時は、上記の 2 行を [macro][endmacro] タグを用いて、シナリオ 
の冒頭などでマクロ化しておくと便利なのです。 


•タグ記逋例 

[macro name= 新しいマクロの名前 ]¥ 

マクロ化したいタグ行（何行でもよ い） 

[encunacro] ¥ 

•シナリオ例 

f*start 

I 

[macro name=kirikae] ¥ 

[trans time=2000 rule="trans1.png" vague=100]¥ 
[wt ]¥ 

[endmacro] ¥ 


*scene01 
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この例の場合、 [ transj と [ wt ] の行が [ kirikae ] という名前の新しいマクロタグ 
に定義されました。以後は [ trans 】[ wt ] の2行で処理を行なう部分に、 [ kirikae ] 
というオリジナル • タグを使うことができます。 

このように マクロを 使えば、簡単にオリ ジナルのタグを 作れるので非常に便 
利ですが、使いすぎると困ったことになります。 

たとえば、 

[layopt layer=messageO page=back visible=false]¥ 

のような 1 行の記述をマクロにする意味はあまりありません。 


[layopt 丄 ayer=messageO page=back visible=true] ¥ 

— [backlay]¥ _ 

の埸合は、使い方によっては便利ですが、そうでない場合もあります。 

なぜなら、特にそれだけで完結していない処理をマクロに定義すると、前後 
の関係から再度それを分解しなければ処理を変更できないことが多いからです c 

完全にシナリオが書き上がった時点で同じ記述がされている行をマクロ化し 
て視認性を高めるならかまいませんが、例のようなケースは「どのような処理 
を行なっているのか」が分かりにくいため、マクロにしないほうがよいでしょ 
う。 

ですが、短いタグでもマクロに定義したほうが便利な場合もあります。 
[playbgm storage= n shock.mid M loop=false]¥ 

[wb]¥ _ 

この例では、 「 shock 」 という名前の短い MIDI ファイルをループさせずに一 
度だけ鳴らす処理をしていますが、この場合は属性の変更はあり得ないのでマ 
クロ化するメリットがあります。 


マクロのメリットで最も大きい点は属性部分の値が完全に統一できることな 
ので、定型処理をマクロに登録しておけば、前回の処理を参考にして属性に 
同じ値を記述するような面倒を犯す必要はありません。 


マクロの基本的な使い方 
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マクロを活用する 

癱 


■マクロに属性を与える 


下記の例のように、派手にマクロにした t 、のに微妙な記述の違 t ゝがあつて断 
念したことはありませんか？ 


•シナリオ例1 

[layopt 1 ayer=message 0 page=back visible=false]¥ 

[image storage 二 " dinner•jpg" layer=base page=back]¥ 
[trans time=2000 rule= n transOl.png" vague=100]¥ 
[wt]¥ 

[layopt layer=messageO page=fore visible=true]¥ 

•シナリオ例 2 

[layopt 丄 ayer=messageO page=back visible=false]¥ 
timage storage 二 ’ .drive.jpg" layer=base page=back]¥ 
[trans time=2000 rule="trans01.png" vague=100]¥ 
[wt]¥ 

[layopt layer=messageO page=fore visible=true]¥ 


•シナ U 才例 3 

[layopt 1ayer=messageO page=back visible=false]¥ 

[image storage:., forest • jpg" layer=base page=back] ¥ 

[trans time=2000 rule 二 ’ • trans01.png" vague=100] 

[wt ] ¥ 

[layopt layer=messageO page=fore visible=true]¥ 

この例では、① [ image ] タグで画像を base レイヤーのバックグラウンドに読 
み込み、②2秒でトランジションさせ、③さらにその終了を [ wt ] で待ってか 
ら、④ [ layopt ] タグでメッセージレイヤーのフォアグラウンドを可視状態にす 

る-という一連の処理をしています。ここで異なるのは [ image 】 タグの stor - 

age 属性だけですが、このように属性が異なるだけで他の一連の処理が同一の 
埸合も、属性を引き渡すことによってマクロ化することができます。 

ただし、異なる指定がされている属性部分は マクロ 化できないため、 マクロ 
自体で属性を指定して、それを マクロ 内のタグに引き渡さねばなりません。 
先の例を マクロ 化するには、次のように記述します q 
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綠 M を乾免:為ぐ治%:辟々て:か城後魯微鞠彌 


7-1 マクロの基本的な使い方 

翁#春# 


m 

1# #參 


翁マクロ定翻 

[macro naine=gamenkirikae] ¥ — 

[layopt layer=messageO page=back visible=false]¥ 

[image storage=%storage layer 二 base page=back]¥ 

[trans time=2000 rule="transOl.png" vague=100]¥ 

[wt]¥ 

[layopt layer=messageO page=fore visible=true]¥ 

[endmacro]¥ 

[ image ] タグの storage 属性の部分に書かれた 「％ storage 」 という部分が、新 
しい [ gamenkirikae ] 9 グの storage 属性として利用できます。 

このマクロを使って最初の記述 ^ (J を書き直すと、以下のようになります。 

•シナリオ例1 

Lgamenkirikae storage="dinner opg"] ¥ 

♦シナ U 才例 2 

Lgamenkirikae storage:"arive opg"]¥ 

•シナ U 才例 3 

[gamenkirikae storage=”forest.jpg"]¥ 

マクロ定義行で半角の％の次に指定されてい i 文字列がオリジナル • タグの 
属性として利用できるわけです。 

「 storage 」 ではややこしくて嫌だという人は、次のように書いてもかまい 
ません。 

•マクロ定義例 

[macro name=gamenkirikae] ¥ 

[image storage=%gazou layer 二 base page=back]¥ 

[trans time=2000 rule="transOl.png" vague=100]¥ 

[wt ] ¥ 

[layopt 1ayer=message0 page=fore visible 二 true]¥ 

[endmacro]¥ _ 
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マクロを活用する 




このようにマクロを定義しておくと、次のような記述で新タグが使えます。 

•タグ gE 述例 _ 

[gamenkirikae gazou= "dinner • jpg” ]¥_ _ 


この場合は、 「 gazou 」 という属性に指定されたファイル名か [image ] タクの 
storage 属性にそのまま渡されます。 

また、ルール • ファイルも使うたびに指定したい場合は、次のように定義し 
ます。 

•マクロ定義例 

[macro name=gamenkiriKaej ¥ 

[image storage=%gazou layer 二 base page=back]¥ 

[trans time=2 000 ru=%rule vague=100]¥ 

[wt]¥ 

[layopt layer=messageO page 二 fore visible=true]¥ 

[endmacro]¥ 

•タグ記述例 

[gamenkirikae gazou="dinner.jpg" ru="trans2.png"]¥ 

このように、マクロ定義タグ [macro][endmacro] を利用すれば、タグだけで 
なく属性もオリジナルのタグを生成することができ、非常に便利です。 


I 選択肢をマクロ化する 


選択肢は、ノベルやアドベンチャーゲームになくてはならないものです。こ 
の部分をマクロ化すると、非常に便利です。 


その前に、まず選択肢の記述について考えてみます。次の例は、横書きの 
ノベル形式の選択肢です。 







マクロの基本的な使い方 



•シナ U 才例 

[er]¥ 

「言いなさいよ0言わないとサイドブレーキ引くわよ」 

[link target=*chapter0_scenel4] A. 天気がいつもこうだったらい 
いのに [endlink] 

[link target=*chapter0_scenel5] B. 車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C . 胃の調子がいつもこうだった 
らいいのに [endlink] ¥ 


シンプルに書けばこのようになりますが、これでは選択肢としては中途半端 
です。そこで、選択肢の文字に対して以下のような表現を追加してみます。 

① 一瞬で表示されるようにする。 

② メッセージ履歴に残さないようにする。 

③ 画面の下端に表示する。 

①を可能にするには、 [ nowait 】[ endnowait ] タグを用います。 

•シナリオ例_ 

[er]¥ 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[nowait]¥ 

[link target=*chapterO 一 scenel4] A . 天気がいつもこつだったらい 
いのに [endlink] 

[link target=*chapterO 一 scenel5] B • 車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C • 胃の調子がいつもこうだった 
らいいのに [endlink] ¥ 

[endnowait] ¥ 


KAG 
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マクロを活用する 



さらに②を可能にするため、 [history] タグを用います。 

•シナリオ例 _ 

[er]¥ 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[nowait]¥ 

[history output=false] ¥ 

[link target=*chapter0_scenel4] A. 天気がいつもこうだったらい 
いのに [endlink] 

[link target=*chapterO 一 scenel5] B ,車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6 ] C. 胃の調子がいつもこうだった 
らいいのに [endl ink ] ¥ 

[history output=true] ¥ 

[endnowait]¥ 


[history】 タグはメッセージ履歴への文字の出力を制御するためのタグで、 rout- 
put=false」 と書いた時点から画面に書かれた文字はメッセージ履歴に出力されな 
くなります。元に戻すには、再び [history] タグを記述し、 「output=true」 とします。 

③を可能にするため、 [locate】 タグで位置指定を行ないます。 

參シナリオ例 

[er]¥ 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[locate y=365] ¥ 

[nowait] ¥ 

[history output=false]¥ 

[link target=*chapter0_scenel4] A. 天気がいつもこうだったらい 
いのに [endlink] 

[link target=*chapter0_scenel5] B. 車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C • 胃の調子がいつもこうだった 
らいいのに [endlink] ¥ 

[history 011 tput=true] ¥ 
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マクロの基本的な使い方 


_一‘ ■■■. 一..： ■… ■■■■: 





これで、3つの選択肢を表示する記述は終了しました。続 t ゝてマクロ化し r みます。 

籲マク□定義例1 

[macro name=select3] ¥ 

[locate y=365]¥ 

[nowait]¥ 

[history output=false]¥ 

[endmacro]¥ 




春マクロ定義例 2 

[macro name=endselect]¥ 
[history output=true]¥ 
[endnowait]¥ 

[endmacro]¥ 


:ぐ.':::: 

ハ:::..::::.：. 
ベ:.::：：:::::::.:::.. 


これで [ select 3】[ endselect ] という2つのオリジナル • タグが利用できるよう 
になりました。このオリジナル•タグを使って元のシナリオを書き換えてみます。 

_シナリオ例 


「言いなさいよ0言わないとサイドブレーキ引くわよ」 

[select3]¥ 

[link target=*chapter0_scenel4] A. 天気がいつもこうだらたらい 
いのに [endlink] 

[link target=*chapterO 一 scenel5] B _ 車の調子がいつもこうだつた 
らいいのに [endlink] 

[link target=*chapterO_scenel6] C . 胃の調子がいつもこうたつた 
らいいのに [endlink] ¥ 

[endselect] ¥ 








ずいぶんすっきりしたと思います。ただし、このマクロでは、選択肢の数が 
3つのときにしか使えません。そこで、2つや4つの場合の [ select 2】 や [ select 4] 
もそれぞれ定義しておきます。 


[macro name=select2] ¥ 
[locate y=385]¥ 
[nowait]¥ 

[history output=ralse 
[endmacro)¥ 


[macro name=select4]¥ 
[locate y=345]¥ 

[nowait]¥ 

[history output=false]¥ 
[endmacro]¥ 


それぞれ画面下端に配置したいので、 [ locate ] で指定する Y 座標を文字サイ 
ズと行間サイズを考慮に入れて変更します。この値は rConfig . tjsJ の設定に 
よって変化するので、必ず確認してください。 
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廳灣__麗__國圓__調 


7-1 マクロの基本的な使い方 

龄響麵議麵___醇^ 


■ 


さらに、選択肢そのものをマクロ化することも有益です。 

ボタンやリンクの上にマウス.カーソルが乗ったりクリックしたりすると音 
が出るソフトがありますが、 KAG の [ link ] タグでも同様のことができます。 

•シナリオ例 

[select2]¥ 

[link enterse= "otol .wav" clickse 二 ’' oto2 .wav" target= 
*chapter0_scene22 ] A . 「ここで待っているかい？」 [endlink] 

[linK enterse="otol.wav" clickse=”oto2•wav" target= 
*chapter0_scene23 ] B . 「一緒に行く かい？」 [endlink] ¥ 
[endselect]¥ 

[s] 


[ link ] タグの属性に「 enterse 』 カーソルがフォーカスしたときの音ファイル 
名”」と 「 clickse = n クリックしたときの音ファイル名"」を指定してやれば、こ 
の選択肢は音っきになります b 

でも、すべての選択肢に上の例のような書き方をしていると、見にくいです 
よね。そこで、マクロを使います。 

•マクロ定義例 

[macro name=links]¥ 

[link enterse="otol.wav" clickse="oto2.wav" 
target=%target]¥ 

[endmacro] ¥ 

[ link ] に sound を付けたということで、 [ links ] タグを作ってみました。これ 
でシナリオ例を置き換えると、次のようになります。 

•シナリオ例_ _ 

[select2]¥ 

[links target = *chapter0_scene22 ] A . 「ここで待っているかい？」 
[endlink] 

[links targe t = *chapterO_s cene 2 3 ] B . 「——緒 t こ行く 力、し、？」 
[endlink] ¥ 



129奢 














11111 


マクロを活用する 


[endselect ] ¥ 
[s] 


ン:'ヘリ 


■ill 

Ills 

_人: 


II 


私の場合 、 「[call 
storage =" macro.ks 
" target =* start ]¥」 
の1行をエディタ 
の シヨー トカット 
に登録してあり、 
必要に応じて呼び 
出しています。 

シナリオを書い 
ていて、もしマク 
口に修正が入った 
場合は、①上の1 
行を本シナリオに 
仮害き込みしてマ 
クロ定典部分を実 
行し、②その後セ 
ーブデータを保存 
してから、③上の 
1行を削除してシ 
ナリオを元の状態 
に戻しています。 

シナリオが長く 
なってくると first.ks 
部からのリプレイ 
は現実的ではない 
ので、任意の場所 
からマクロ定典フ 
アイルを呼べる状 
態にしているわけ 
です。 



ここで注意ですが、 [ links ] タグから [ link ] タグの属性に引き渡す内容は、こ 
の場合は 「 target 」 のみとなっています。シナリオ内でジャンプするだけなら 
これで充分ですが、私の場合は、下記のように [ links ] タグを定義しています。 


[macro name=lmks]¥ 

[link enterse 二 " otol .wav" clickse= ,, oto2 .wav" 
target=%target exp 二％ exp]¥ 

[endmacro]¥ 


storage=%storage 


ジャンプ先のラベルを指定する target 属性だけでなく、ファイル間ジャンプに 
利用する storage と変数を処理するための exp 属性も引き渡すようにしてもゝます。 

このようにしておけば、いざ 「 storage 」 や 「 exp 」 を使いたくなったときにも、 


[links storgae="xmaseve02.ks" target=*chapter2_scene0_set 
exp="f.hensuu=l"]¥ 


のように記述できるからです。 

このような定義をしておかないと、使えると思ったはずの属性が使えないこ 
とになったりするので、注意してください。マクロの属性がうまく効いていな 
いと思ったら、マクロの定義記述が間違っていることを疑うとよいでしょう。 

また、マクロの記述データはセーブ • データに保存されるので、マクロを定義 
する前のセーブ.データをロー ドした場合、定義したマクロが使えない場合が 
あります。これは、すでに定義したマクロの内容を修正した場合も同様です。 

このような場合には、もう一度マクロの定義行を通過する形でリプレイしな 
いと、修正部は発動しません。 
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「クリッカブル•マップ」とは、画像の一部分をクリックしたらの指定のラ 
ベルにジャンプすることを可能にするものです。 

これを「吉里吉里/ KAG 」 で実行するには、以下の3つのファイルが必要です。 


任意のファイル名.拡張子 


《領域画像》 

これは、ベース画像のクリック領域を色分けしたもので、256色の PNG ファ 
イルでないといけません。256色が取り扱えるフリーソフトなどを利用してべ 
ース画像の形状を元にクリック領域をそれぞれ単色で塗りつぶしていくのです 
が、このときカラー パレ ットのインデックス番号が1の色から使う必要があり 
ます。 


領域画像 

任意のファイル名 _p.png 

領域アクション定義ファイル 

任意のファイル名. ma 
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8-1 クリツカブル•マツプの作成方法 





# _ _樂參鬱_ 

領域画像を作る 
には256色専用の 
ペイントソフトが 
便利です。フリー 
ソフトにはよいも 
のがあるので探し 
てみるといいでし 
よ9。 


領域画像例： exit _ p.png 


•領域画像のバレット 



青 (1) 水色 (2) ピンク (3) 黄緑⑷黄⑸赤⑹ 


パレットの左上 
が〇番の色になり 
ます。ここは必ず 
黒にしておきます。 


この例では、パレットの左側から順番に「0」「1」「2」というパレット•イ 
ンデックス番号がついています。このため、青は「1」、水色は「2」、ピンクは 
「3」、黄緑は「4」、黄色は「5」、そして赤が「6」になります。このパレット • 
インデックス番号は後述の領域アクション定義ファイルに利用するので、きち 
んと把握しておく必要があります。 

《領域アクシヨン定義フアイル》 

中身は以下のようになっています。 


•領域アクション定義ファイル例 「 exit_maj 

hint:' ■非常口 1, ; storage= " first. ks " ； target 二 , ’* sceneOl "; 

2 : hint 二 " 窓"； storage 二 " first.ks"; target 二 "* scene02"; 

3 : hint="; storage=" first. ks" ； target=" *scene03 "； 

4 : hint:” 奥の壁"； storage="first.ks " ； target="*scene04"; 

5 : hint = "非常口の ガラス"; storage:" first, ks"; target=" *scene05 "； 
6 : hint = "教室の扉 "; storage:" first .ks"; target^" *scene06"; 


左の例ですが、 
hint = は無理に記述 
する必要はありま 
せん。むしろ記述 
しない方が ゲーム 
内のクリッカブ 
ル•マップらしく 
てべターです。 
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クリツカブル • マップの利用 


それぞれの行の構成は「領域番号（半角の「:」）アクション」で構成されて 



いますが、行頭にある「1」から「6」までの数字が領域画像で塗った色のパ 
レット番号になります。 

青色で塗ったのは「非常口の扉」なので1行目に、水色で塗ったのは「窓」 
なので2行目に、というように色のパレット番号に合わせてジャンプ先のファ 
イルやラベルを記述していきます。 

アクションについては KAG の説明からはやや外れますが、「属性名=値；」 
とう形式でいくつでもつないで書くことができます。 


•アクション記述例 



クリックされたときにジャンプするファイル名を指定。 

■画_:;:::''.] 

クリックされたときにジャンプするラベル名を指定。 


領域内に力ーソルが入つたときに実行する TJS 式を指定。 


領域内から力ーソルが出たときに実行する TJS 式を指定。 

C 篇 

マウスが乗ったときに表示される文字列を記述。 

r 霞， 

変数処理や、 TJS 機能の呼び出しなどの TJS 式を指定。 


マウスカーソル.ファイルやマウスカーソル定数を指定。 


以上の3つのファイルを同一のフォルダに入れれば、クリッカブル•マップ 
の準備は完了です。背景画像をクリッヵブル • マップとして利用するなら 
「 bgimage 」 フォルダへ、前景画像なら 「 fgimage 」 フォルダへ入れましょう。 
「 other 」 でもかまいません。 


続いてシナリオ • ファイルでクリッカブル.マップを呼び出す記述を行ない 
ますが、これは [ image 】 タグで行ないます。ベース画像と同名の 「_ p . png 」 
と . ma ファイルが存在すれば、ベースとなる画像を [ image ] タグで普通に呼び 
出しただけでクリッカブル.マップが用できます。 


•タグ記逋例 


[i 


imacn 


e 丄 ayer=base page=fore s 
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•シナリオ IB 述例 

★start 

[er]¥ 

[image layer=base page=fore storage= M exit.png H ]¥ 
[s] 


*scene01 

[er]¥ 

非常口は鍵が掛かっていて、押しても引いても開かなかった。 [1] 

[jump target=*start] ¥ 

[s] 


*scene02 

[er]¥ 

窓からは外の光がうっすらと差し込んでいる。 [1] 

[jump target=*start] ¥ 

[s] 


*scene03 

[er]¥ 

天井……そこは調べようがない。 [1] 

[jump target=*start]¥ 


*scene04 

[er]¥ 

非常口の扉がついている奥の壁はコンクリートでできていた。 [1] 

[jump target=*start] ¥ 


*scene05 

[er]¥ 

非常口のガラスはワイヤーメッシュの入った強化ガラスで、その上模様が入 
っているので向こう側の様子はわからない。 [1] 
















# # 鬱 # 參# 


クリッカブル • マップの利用 


[jump target 二 * start]¥ 


*scene06 

[er]¥ 

先ほど来た時にひどい目に遭った 3 年 2 組の教室へ入る扉だ。 [1] 
[jump target=*start] ¥ 




クリツカブル ♦ 
マツプはアド ベン 
チャーゲームでは 
必須の機能ですが、 
シナリオに [ link ] 夕 
グが1つもないの 
に分岐処理が行な 
えるので、ちよつ 
と不思議な感じが 
しませんか？ 


i 

\ 


mmm \ 

システム#雜表鄉> 織■<』> 



乾 1 ’虞■•說 觀禮, 


非常 M のガラスはワイ- 
で、 その I :校;様が人つ 
からない,, 


ゾ -ーメッ シュの.人 
ているのでご: 


った強化ガ : : 
1 刪の様广 U 




実行例 



ップを有効のまま利用する 


先ほどの例では、それぞれのジャンプ先から [ jump ] タグを使ってクリッカブ 
ル•マップ表示部分に戻っていましたが、これは「領域番号0」を使った特殊 
な指定をすることにより、シナリオを大幅に改善することができます^ 
具体的な方法ですが、領域アクション定義ファイル内に「領域番号0」を記 
述し、次のように記述します。 
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•領域アクション定義ファイル例 rexit.maj 

! 0: autodisable=false ； 

1: hint:" 非常口 '; storage:"first • ks" ； target="*scene01 "； 

2 : ; storage=" first .ks"; target= H *scene02 "； 

3 : hint= "天井”； storage:" first .ks"; target=" *scene03 "; 

4 : hint= " 奥の壁 " ； storage="first .ks" ； target=" *scene04"; 

5: hint = "非常口の カラス ,, ； storage= "first. ks"; target: 

” *scene05"; 

6: hint =" 教室の JP ; storage=" first • ks"; target=" *scene06 "； 


1 行目に「領域番号0」の行を加えることにより、クリッカブル•マップを 
クリックしても、クリッカブル •マッ プは無効になりません。 

先の例ではこの指定を行なわなかったため、それぞれの ジャンプ 先から再び 
ラベル r*startj へ 戻り、 [ image ] タ グによる クリッ カ ブル•マップ 画像のロー 
ドを行なっていましたが、「領域番号0」の行を加えることで不要になります。 

•シナリオ記述例 

★start 

[er]¥ 

[image layer=base page 二 fore storage="exit.png"]¥ 


*scene01 

[er]¥ ブ 

非常口は鍵が掛かっていて、押しても引いても開かなかった。 [1] 
[s] 

/ 

*scene02 

[er]¥ 

窓からは外の光がうっすらと差し込んでいる。 [1] 

[s] 

/ 

*scene0^ 

[er]¥ 
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天井……そこは調べようがない。 [1] 

[S] 


*scene04 

[er]¥ 

非常口の扉がついている奥の壁はコンクリートでできていた。 [1] 

[s] 

9 

*sceneOb 

[er]¥ 

非常口のガラスはワイヤーメッシュの入った強化ガラスで、その上模様が入 
っているので向こう側の様子はわからない。 [1] 


*sceneOb 

[er]¥ 

先ほど来た時にひどい目に遭った3年2組の教室へ入る扉だ。 [1] 


このように [ jump ] タグをそれぞれのジャンプ先に置かなくても、常に画像が 
表示されている間はクリッカブル.マップが有効になっているため、別の領域 
をクリックすることができるのです。 


ップの条件分岐 


[ if ] タグと同様に、クリッカブル • マップでも変数などの条件によって有効 
にしたり無効にしたりできます。 

基本的にクリッカブル • マップではアクションが何も定義されていなければ 
その領域は無視されます。これを応用して、一度クリックして調べた場所は次 
からクリックできないようにしてみます。 












8-1 クリツカブル•マツプの作成方法 

ね wav : も^ ；纪激赞總纖^滅^淡资:知せ今说热たがい 


• exit.ma 記述例 

0 : autodisable=false ； 

1: if (f.sc01!=l) {hint= "非常口"； storage:’’first • ks •_; target 
二 "* sceneOl";} 

2: if(f•sc02!=1){hint= " 窓 " ； storage:”first,ks";target 
="*scene02";} 

3 : if (f • sc03 !=1){hint:" 天井"； storage:’’first • ks ”； target 
=_• *scene03 " ；} 

4: if (f .sc04!=l) {hint 二"奧の壁"； storage: _， first • ks ，’ ； target 

="*scene04"；} 

5 : if (f • sc05 !=1){hint= "非常口の ガ ラス"； storage^ H first. ks"; 

target = ” *scene05";} 

6 : if (f • scO6 !=1){hint = "教室の扉"； storage? first .ks H ; 

target=_ ， *scene06” ；} 


麵 __1 

1111111 

111111 
is __ 議議議_謹 

議議 

:::馨 

眶圍___, 


擊シナ _ j 才例 


e start 


[image laver=base page=fore storage 二 ,, exit .png” ]¥ 


織綱!^潑 ! 


★sceneOl 

[er]¥ 

[eval exp=”f•sc01=l"]¥ 

非常口は鍵が掛かっていて、押しても引いても開かなかった。 [1] 


*scene02 

[er]¥ 

[eval exp="f.sc02=l"]¥ 

窓からは外の光がうっすらと差し込んでいる。 [1] 


I 

:禱 ::1 

観 1 









クリツカブル • マップの利用 



領域アクション定義の行で、 if ( f •変数名! =1) {アクション}という記述をする 
ことにより、 「 f . 変数名」が「1」でない場合は{アクション}を実行するように 
してあります。 

そして、それぞれのジャンプ先で [ eval ] タグにより 「 f . 変数名」に「1」が代 
入されることによって、再び KAG シナリオが領域アクション定義の行を参照 
しても{アクション}は実行されなくなるわけです。 




■クリツカプル•マツプを使い終えたら 


クリッカブル ♦ マップを伴う画像が存在していると、シナリオはキーボード 
によるマウスエミュレーション • モードで実行されます。 

これには弊害があり、 edit タグのようなキーボードを用いるほかの機能が正 
常に動作しなくなるので、クリッカブル.マップは使用を終えた後できちんと 
片付ける必要があります。 


參シナリオ例 



base レイヤーに読み込んだ背景画像は上のような記述でクリッカブル♦マッ 
プを無効化しておきます。 


前景レイヤーに読み込んだ場合は、その画像を引き続き使う必要がないなら、 
[ freeimage ] 9 グを利用してクリッカブル•マップを画像もろとも破棄します。 

參シナリオ例 

[freeimage layer=0 page=fore] ¥ 

[freeimage 丄 ayer=0 page=back]¥ 

この [ freeimage ] タグはアニメーションする前景画像を開放する場合にも利用 
できます。特にアニメーション ♦ ファイルは rpage = backj などに置いたまま 
にしておくとメモリを無駄に消費するので、必ずこのタグを用いて開放してお 
きましよう。 

また、クリッカブル ♦ マップを持つ画像がロー ドされているレイヤーに別の 
画像をロー ドしてもクリッカブル ♦ マップは解放されて消えます。 

クリッカブル•マップを base レイヤーに背景として読み込んで I ゝる場合は、 
次に表示する背景画像を読み込めばクリッカブル • マップは自動的に無効にな 
るので、トラブルは少ないです。しかし、前景レイヤーに使っている場合には 
解放を忘れることがあるので、注意してください。 




クリツカブル•マップの利用 


# 


8-2 


ク U ツカブル • マップを肱用した CG ギヤラ U - 


クリッカブル.マップの機能を応用することにより、一度見た画像はサ厶ネ 
イル表示し、見ていない画像は「？」の描かれた真っ黒な矩形などで表示す 
る CG ギャラリーを作ることができます。もちろん、サムネイルをクリックす 
ると原寸の CG を表示するものです。 



このような CG ギャラリーを作成するには、以下のような処理をシナリオ化 


することが必要になります。 


① 本シナリオ内で任意の CG を見た時、それを変数に記憶。 

② CG ギャラリーのメニューで変数をチェックし、見た CG のみをサムネイル表示。 


ここまでは、変数と [ if ] 分岐を利用すれば組み上げることができます。 

もし、扱われているイベント CG の枚数があまりにも多くて変数を1つずつ定義 
するのが面倒な場合は、変数名を直接 CG ファイル名から得ることもできます。 

この場合、一度でもゲーム内で表示した（つまりプレイヤーが見た）画像を 
記録するために以下のようなマクロを定義し、 CG アルバムに掲載する画像は 
通常の [ image ] タグではなく、このオリジナル.タグで表示します。 



_マクロ定_例 

| [macro name=imagemem] ¥ 

I [image ★]¥ 

[eval exp="sf[mp.storage]=1"]¥ 
[endmacro] ¥ 
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この [ image 】 タグに毛が生えたような [ imagemem ] タグを利用してゲーム内で 
CG を表示すると、下のシナリオ例の2行目にコメントとして記述されている 
ような [ eval ] タグを用いた変数定義が自動的に行なわれます。 

変数名には [ imagemem ] タグでロードした画像データのファイル名が利用さ 
れ、その値には自動的に「1」が入ります。 

•シナ 1 J 才例 

[imagemem storage="picOl.jpg" layer=base page=fore]¥ 

；[eval exp="sf.pic01=l"]¥ 


ここまでで、シナリオ内で表示した画像については、画像を表示するとその 
画像ファイル名をもつ変数が生成され、値に「1」が代入されることになりま 
した。 

続いて、 CG ギャラリーの メニュー ページを作りますが、考え方は以下のよ 
うになります。 


① すべてのイベント CG のサムネイルを並べた1枚の画像を作成し、 base レイ 
ヤーのフォアグラウンドにロー ドする。 

② [ laycount 】 タグにより、イベント CG の数だけ前景レイヤーを準備する。 

③ それぞれの前景レイヤーに「まだ見ていません」というサムネイルと同サイ 
ズの画像を読み込み、 base レイヤー上の個々のサムネイルを覆 I 、隠す。 

④ それぞれの前景レイヤー上に読み込まれた「まだ見ていません」という画像 
を、シナリオ内部で得た変数の値を元に管理する。具体的には、変数が「0」 
の場合は覆い隠したままにしておき、「1」の場合には取り払う。 

⑤ 「まだ見ていません」画像が取り払われた場合、クリッカブル•マップが有 
効になり、 base レイヤー上のサムネイルをクリックすると、そのサムネイル 
からリンクしている原寸の元 Si 像を画面に表示する。 


[ laycount ] は、メッセージ.レイヤーや前景レイヤーなど、動的に数が変更 
される可能性のあるレイヤーの現在の利用数を指定するためのタグです。 


CG ギャラリーを 
作るために必要な 
前景レイヤーの数 
は base レイヤーに 
並べて1枚絵とし 
て表示したサムネ 
イルの総数に等し 
くなります。 

たとえば4 X 
4=16枚の C G サム 
ネイル画面を作る 
場合には前景レイ 
ヤーは16枚必要に 
なりますが、この 
程度ならば特に W 
題はありません。 

W . Dee さんは 
「サイズが小さい前 
景レイヤーなら、 
数十枚同時に利用 
してもさほど問題 
にならない」と言 
つています。 
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上の例ではメッセージ • レイヤーを2枚と前景レイヤーを10枚準備してお 
り、下の例ではメッセージ ♦ レイヤーを最小数の1枚にし、前景レイヤーはす 
ベて破棄しています。 

また、メッセージ♦レイヤーのみ、前景レイヤーのみを指定することもできます。 

•8 B 逋例 


以下に、 16 X 16 のサムネイルを「？」の画像で隠しておき、シナリオ内で 
見た画像だけサムネイルを表示するシナリオを書いてみます。 

參シナリオ例 

| *start 

[position layer=messageO 1 e f t = 0 top = 0 width=640 
height=480 opacity=150]¥ 

L 丄 ayopt 1ayer=message0 page=fore visible^true]¥ 

f 

，•すべての変数を 0 にします。 

[eval exp="sf.pic01=0 M ]¥ 

[eval exp 二 " sf.pic02=0"]¥ 

[eval exp= H sf.pic03=0 H ]¥ 

[eval exp= n sf.pic04=0 H ]¥ 

[eval exp 二 "sf.pic05=0"]¥ 

[eval exp="sf.pic06=0 M ]¥ 

[eval exp= M sf.pic07=0 ,1 ]¥ 

[eval exp="sf.pic08=0"]¥ 

[eval exp="sf.pic09=0 H ]¥ 

[eval exp="sf.picl0 = 0 n ]¥ 

[eval exp="sf.picll=0"]¥ 





[laycount messages=2 layers=10]¥ 
[laycount messages=l layers=0]¥ 





— •144 





8-2 クリツカブル•マップを応用した CG ギャラリー 



[eval exp= M sf.picl2=0"]¥ 

[eval exp= H sf.picl3=0"]¥ 

[eval exp="sf.picl4=0"]¥ 

[eval exp= H sf.picl5=0"]¥ 

[eval exp= n sf.picl6=0"]¥ 

7 

，•以下の行は本来なら各シナリオで CG を見た時に 1 になるシステム変数です。 
，•ここではデバッグの意味もあり、16個の変数を手動で操作します。 

，•本来はこれらの変数は先に定義した [imagemem] タグで管理します。 

，•見たことにしたい画像の行から先頭のセミコロンを外してみてください。 

; [eval exp="sf.pic01=l"]¥ 

[eval exp="sf.pic02=l"]¥ 

；[eval exp="sf.pic03=l"]¥ 

；[eval exp="sf.pic04=l"]¥ 

；[eval exp="sf.pic05=l"]¥ 

[eval exp= M sf.pic06=l"]¥ 

[eval exp 二 " sf .pic07=l__ ]¥ 

[eval exp="sf.pic08=l"]¥ 

;[eval exp="sf.pic09=l"]¥ 

；[eval exp="sf,piclO=l"]¥ 

[eval exp 二 ，’ sf.picll=l"]¥ 

；[eval exp="sf.picl2=l"]¥ 

；[eval exp="sf.picl3=l"]¥ 

；[eval exp="sf.picl4=l n ]¥ 

[eval exp="sf.picl5=l"]¥ 

；[eval exp="sf.picl6=l"]¥ 

[link target 二* eg 一 room] CG ギャラリーへ行く [endlink]¥ 

[s] 


.* eg—room 
[er]¥ 

7 

;16 X16 のサムネイルが並べられた 1 枚の画像を base レイヤーに表示します。 
[image storage 二 ” allpic.bmp n layer 二 base page=fore]¥ 
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___ 鐘 


，•前景レイヤーを 17 枚にします。 

[laycount layers=l フ]¥ 

/ 

; 全ての前景レイヤーを見えるようにします。 

[layopt layer=0 page=fore visible=true]¥ 

[layopt layer=l page=fore visible=true]¥ 

[layopt layer=2 page=fore visible=true]¥ 

[layopt layer=3 page=fore visible=true]¥ 

[layopt layer=4 page=fore visible=true]¥ 

[layopt layer=5 page=fore visible=true]¥ 

[layopt layers6 page=fore visible=true]¥ 

[layopt layer=7 page 二 fore visible 二 true]¥ 

[layopt layer=8 page=fore visible=true]¥ 

[layopt layer=9 page=fore visible=true]¥ 

[layopt layer=10 page=fore visible=true]¥ 

[layopt layer=ll page=fore visible=true]¥ 

[layopt layer=12 page=fore visible=true]¥ 

[layopt layer=13 page=fore visible=true]¥ 

[layopt layer=14 page=fore visible=true]¥ 

[layopt layer=15 page=fore visible=true]¥ 

/ 

， • それぞれの前景レイヤーに「？」マークの画像を置きます。 

， • この画像はシステム変数によって表示されたりされなかったりします。 

[image storage="notyet.bmp"layer=0 page=fore 丄 eft=0 
top=0 cond= ■_ sf. pic01==0" ] ¥ 

[image 各盘難喻 tyet. bmp" layer=l page=fore left=160 
top=0 cond= M sf.pic02==0"]¥ 

[image storage="notyet.bmp" layer=2 page=fore left=320 
top=0 cond="sf.pic03==0" ] ¥ 

[image storage="notyet•bmp"layer=3 page=fore left=480 
top=0 cond="sf.pic04==0"]¥ 

[image storage="notyet.bmp"layer=4 page=fore left=0 
top=120 cond="sf,pic05==0"]¥ 
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マツプを応用した CG ギャラリー 

ぐ.;..:'ン邏議議漏 


.ぐ’:.::. 




#拳#⑩❿#秦 


Limage storage="notyet.bmp” layer=5 page 二 fore left=160 
top=120 cond="sf.pic06 二 =0 n ]¥ - 

L image storage 二 ,, no tyet • bmp" layer 二 6 page=f ore lef t = 320 
top=120 cond=" sf .pic07==0 ,r ] ¥ 

limage storage^"notyet.bmp" layer=7 page=fore left=480 
top=120 cond= n sf.pic08==0 H ]¥ 

Limage storage 二 " notyet.bmp" layer=8 page 二 fore left=0 
top=240 cond 二 " sf.pic09 二 =0”]¥ 

[image storage= H notyet .bmp' 1 layer=9 page=f ore lef t=160 
top=240 cond="sf.picl0==0 H ]¥ 

[image storage^ n notyet.bmp"layer=10 page=fore left 二 320 
top=240 cond="sf.picll==0 M ]¥ 

[image storage:"notyet.bmp" layer=ll page=fore left=480 
top=240 cond= H sf.picl2==0 M ]¥ 

[image storage:"notyet.bmp n layer=12 page=fore left=0 
top=360 cond="sf.picl3==0 H ]¥ 

[image storage="notyet.bmp M layer=13 page=fore left 二 160 
top=360 cond="sf.picl4==0"]¥ 

[image storage 二 , 'notyet.bmp" layer=14 page 二 fore left=320 
top=360 cond= H sf.picl5==0 M ]¥ 

[image storage= H notyet.nmp H layer 二 15 page=fore left=480 
top=360 cond= M sf.picl6==0"]¥ 

[link target=*retiirn_start] メ ニユー t し民る [endlink]¥ 

[s] 

f 

; メニューに戻るために前景レイヤーを 0 にし、黒い画像を base に読み込み 
ます。 

★return—start 
[er]¥ 

[laycount layers=0]¥ 

[image storage 二 ,, black .png” layer=base page 二 fore]¥ 

[jump target=*start]¥ 

[s] 


[ image ] タグの末 
尾にある cond 属 ti 
は、 [ if ] タグと同じ 
働きをします。 
fcond = J の後ろに 
害かれた評価式が 
14 真”の場合、つま 
り式を満たしてい 
るときのみ 、 cond 
属性が記述されて 
いるタグが実行さ 
れるようになりま 
す。 

この場合は 
" sf . pic 0 x ==0" です 
から、指定のイべ 
ント CG を見ていな 
い場合に [ image ] 夕 
グが実行され、 r?j 
マークの 描かれた 
黒い矩形が表示さ 
れてサムネイルを 
覆い隠しています。 

cond 属性はほと 
んどのタグに利用 
できるので、 [ if ] 夕 
グを充分に理解で 
きたら使ってみる 
とよいでしよう。 




v: ベ., 

:- 

■ 

.. 
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クッカプル • マップの利用 1 

纖__顆解漏 ' … 『 ■ I 國議麟講 ，_讓麵暖 il ' :' 纖謹!酬麵 

籲 

；それぞれのクリッカブルマップがクリックされた時にジャンプする先です。 

;本来はここで原寸の CG を表示します。 

I ^pshowOl 
| [er]¥ 

1番目の画像がクリックされました。 

[s] 

*pshow02 
I [er]¥ 

2番目の画像がクリックされました。 

1 '[s] 

:卜 *pshow03 

1 [er]¥ _ 

3番目の画像がクリックされました。 

I [s] 

*pshow04 
S [er]¥ 

4番目の画像がクリックされました。 

1 [s]. 

*pshow05 

[er]¥ 

5番目の画像がクリックされました。 

^ [s] 

*pshow06 

[er]¥ 

6番目の画像がクリックされました。 

[s] 

*pshow07 

[er]¥ 

7番目の画像がクリックされました。 

> [s] 

*pshow08 

[er]¥ 

8番目の画像がクリックされました。 

㈤ 

















8-2 クリッカブル•マップを応用した CG ギヤラリー 

ハ.…て '.'… ''へ ハン . パ…：..ハ.ハンい，二'.… ， .，ベ'':.. 


*pshow09 

[er]¥ 

9 番目の画像がクリックされました。 

[s] 

*pshowlO 

[er]¥ 

10 番目の画像がクリックされました。 

[s] 

★pshowll 

[er]¥ 

11 番目の画像がクリックされました。 

[s] 

*pshowl2 

[er]¥ 

12 番目の画像がクリックされました。 

[s] 

*pshowl3 

[er]¥ 

13 番目の画像がクリックされました 。 : 

[s] 

*pshowl4 

[er]¥ 

14 番目の画像がクリックされました。 

[s] 

*pshowl5 

[er]¥ 

15 番目の画像がクリックされました。 

[s] 

*pshowlb 

[er]¥ 

16 番目の画像がクリックされました。 

[s] 
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クリッカブル • マップの利用 


続 V ゝて領域アクション定義ファイルの内容です。 


•領域アクション定義ファイル 「 allpic . maj 記述例_ 

0: autodisable=false ； 

1: if (sf .pic01==l){storage:" first .ks"; target= ， _★pshowOl，• ；} 

2 : if(sf.pic02==l){storage^"first.ks"; target:"*pshow02";} 

3 : if (sf -pic03==l){storage=”first .ks"; target? *pshowO3 •_;} 
4: if(sf-pic04==l){storage= M first.ks H ; target:"*pshow04";} 

5: if(sf.pic05==l){storage="first.ks M ; target 二 " *pshowO5";} 
6: if (sf .pic06==l){storage^"first: ， ks“ target="^pshowO6 H ；} 

7: if (sf .pic07==l) {storage=“ first .ks" ； target= f, *pshow07 M ;} 
8: if(sf.pic08==l){storage="first.ks"; target:”★pshowOS";} 
9: if(sf.pic09==l){storage="first.ks M ； target="*pshow09”；} 
10 : if ( sf .picl0==l ){ storage:’’ f irst .ks " ； target 二 " *pshowl0 ” ；} 
11 : if(sf.picll==l){storage="first.ks "； target= w *pshowll”；} 
12 : if (sf .picl2==l){storage? f irst .ks" ； target 二 ” *pshowl2 f, ;} 
13: if(sf,picl3==l){storage="first.ks"; target:”^pshowl3 H ;} 

14 : if (sf .picl4==l){ storage=" first 二 . ks"; target=" *pshowl4 •’ ；} 

15 : if (sf ,picl5==l){storage= 11 first:. ks M ; target 二 "* pshowl5";} 

16 : if (sf .picl6==l) {storage= n first:.ks M ； targets" ★pshov/16 ",•} 

システム変数が「1」のときに first . ks 内のそれぞれのラベルにジャンプする 
処理を指定しています。 


あとは、サムネイルの並んだベース • ファイルとクリッカブル.マップの領 
域定義ファイルを用意すれば完成です C 



ベース•ファイル 領域定義ファイル 
















スタッフ□ールの作り方や、雪や雨を降らせるな 
ど、 KAG 3 で提供されている面白いブラグインの 
利用方法を中心に、さまざまな機能を解説します。 












r 吉里吉里」のシステム.メニューには、 1 「次の選択肢/未読まで進む」と 
いうコマンドがあります。これをクリックすると、一度見た文章や画像はウエ 
イトのない状態で高速に表示されます。またメッセージが表示されている途 
中で画面をクリックすることによって、クリ、ノク待ち部分まで一気に文章を表 
示する機能もあります。これらの状態を「スキップ狀態」と言います。 


KAG のほとんどのタグは、このスキップ状-を許可しています。これは「ユ 
ーザーを待たせるような処理については、入] J があった埸合はどんどんスキッ 
プする」という仕様が標準になっているから|す a 
ですが、作品を作っていると、ヒントなどが隠された重要な画像を表示する 
ためのトランジションや、制限時間がついている選択肢など、ユーザーが処理 
をスキップしてしまうと都合が悪いものもあります。 

このような状況卩でスキップ状態を強制的こ止めたIゝ埸合は、 [cancelskip] 
というタグを用います。 


[macro name=kirikae] ¥ 

[cancelskip] ¥ 

[image storage 二 ％ storage layer=base page=back]¥ 

[trans method 二 crossfade time=1000]¥ 

[wt] ¥ 

[lay opt layer=messageO page=fore v:Lsible=true] ¥ 




9-1 スキップ状態を制限する 


KAG 


《クリック • スキップ [ clickskip ]》 

[ cancelskip ] によって一度は解除されたスキップ状態も、ユーザーが再度「次 
の選択肢/未読まで進む」コマンドを選んだり、エンター•キー押下などのア 
クシヨンを起こした場合には、再びスキップ状態に入ってしまいます。このよ 
うなことを避けるためには、スキップ機能をいったん停止させるだけではな 
く、その機能自体を無効にしてしまえばよいのです。このようなときに利用す 
るのが、 [ clickskip 】 タグです。 

•タグ記述例 

Lclickskip enabled=false] ¥ 

[clickskip enabled=true]¥ 

上の例でクリック • スキップ自体を禁止し、下の例で再びクリック•スキッ 
プできるように許可しています。クリック • スキップの禁止状態は同じ [ click - 
skip ] タグでないと解除できないので、 「 enabled = false 」 で禁止にした後は、必 
ず 「 enabled = true 」 で解除します。 

•シナリオ例 

厂; ♦ WSa # 切り替え用のマクロ 
[macro name=kirikae] ¥ 

[cancelskip] ¥ 

[clickskip enabled 二 falsej¥ 

[image storage 二％ storage layer=base page-back]¥ 

[trans method 二 crossfade time=1000]¥ 

[wt ] ¥ 

[layopt 1ayer =message0 page=fore visible=true]¥ 

[clickskip enabled=true]¥ 

[endmacro] ¥ 

このようにしておけば、どのようなモードでトランジシヨンまで読み進めて 
きても自動的にいったん停止し、トランジシヨンが終了するまではクリック • 
スキップが無効になります。 
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ここでは、映画やドラマの最後に流れる「牙ヤストロール」や「スタッフロ 
ール」を作ってみます。「吉里吉里/ KAG 」 には、これらスタッフロールを利 
用するための専用プラグイン • サンプルが提供されているので、これを利用す 
ればすぐにできます。 

《プラグイン》 

「 KAG スタッフロール.ブラグイン」は、 rICAG 3¥ KAG 3 plugin ¥ staffroll ¥ sce - 
nario ¥ j の中にある 「 staffix ) ll . ks 」 が本体です。まずはこれを自分のプロジェ 
クト • フォルダ下部の scenario フォルダにコビーしておきましよう。 


「 staffroll . ks 」 は 
2回以上呼び出さ 
ないでください。 
マクロの定義と同 
じで、1回呼び出 
せば、それ以降機 
能が使用可能にな 
I ります。 


《シナリオの書き方〉〉 

続いて、シナリオの書き方ですが、スタッフ ロール •プラグインを使いたい 
プロジヱクトの 「 firstks 」 の先頭行に以下のように記述します。 

•シナリオ記述例 

@call storage 二 ,, staf troll.ks" 


その他の機能 


###### 




讀 



スタッフロール 
にメ ッセージ •レ 
イヤーは使いませ 
ん。 このためスタ 
ッフロー ルを使う 
前にメッセージ • 
レイヤーを非表示 
にしておくとよい 
でしよう。 


勘のい I 、方は気づいたと思いますが、この機能はサブルーチン形式で提供さ 
れています。 「 staffroll . ks 」 の中を開いてみると、いちばん最後の行に 
「@ retum 」 と書かれていることからも分かり K す。このサブルーチンを呼び出 
すことで、以下の5つのスタッフロール用タグが使えるようになります。 


スタッフロ—ルを■化する 
文字を表示する 
staffrolHmape 画像を表 示 する 

スタッフロールのスクロールを 開始す る 
staffroHuninit スタッフロールを i 冬了する 



1 里に利雑か I n つとずま 
苦代を複書フかこはり 
汰時グにをッなの今な 
里の夕常オタれ代、に 
吉 2lvel 非リス作- To 時と楽 
r 2 |たナ、は T 1 のぅん0 f : x — 
KAtm しシばルのあ思ぶた 
1/は用なね一たをいし 
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9-2 スタッフ□ールを作る 


KAG 


•シナリオ例 

@staffrollinit 

@font size=50 color=0xff 0000 

@staff roll text x=100 y=480 text= "すたつふ" 

@resetfont 

@staff roll text x=100 y=80 text= ，，スタッフ 1" 

@staff roll text x=100 y=4 0 text= "スタッフ 2 ” 

@staff roll text x=100 y=40 text= “ スタッフ 3 
©staff roll text x=100 y=40 text= " スタッフ 4 11 
@staff roll image x=100 y=80 storage= "ayari__32 .png" 
©staffrollimage x=100 y=80 storage="kiri_s32.png" 
©staffrollstart height=1500 time=20000 
@wait time=2 0000 
@staffrolluninit 


鬱 # # _ # 響# 


吉里吉里プラグ 
インと KAG プラグ 
インは別のもので 
す。吉里吉里ブラ 
グインは DLL 形式 
で提供され、吉里 
吉里そのものの機 
能を拡張しますが、 
KAG ブラグインは 
シナリオの書き方 
によって実行でき 
る特別な機能を提 
供するシナリオフ 
アイルです。 

吉里吉里プラグ 
インは、吉里吉里 
フォルダ直下の 
plugin フォルダに、 
KAG ブラグインは 
KAG 3 フォルダ直下 
の kag 3 plugin フォ 
ルダに入っていま 
す。 



スタッフ1 
スタッフ2 
スタッフ3 
スタッフ4 



実行例 


r©staffrolltextj 行と 「@ staffrollimage 」 行の 「 x 」 と 「 y 」 や、 「@ staffrol - 
lstart 」 行の fheight 」 「 timeJ > T @ waitj 行の「 time =20000 j の値をいろいろ 
と調整して、自分の作品に合ったスタッフロールを作ってみてください。 
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その他の機能 


m •儀修參 


エンデイング • U ストを作る 


見たエンディング名を白で表示し、まだ見ていないエンディングを灰色で表 
示するようなエンディング，リストを作るには、クリッカブル • マップのとこ 
ろで使ったシステム変数を用います。 


まず、シナリオ内のエンディング記述部分に、 [ eval ] タグでシステム変数を 
記述します。値は「1」を代入しておきます 3 

修シナリオ例 

「一晚中、守ってくれて、ありがとう。明」： p ] 

[wait time=2 000 ] ¥ 

[scenechange storage="00 "]k 
[eval exp="sf.aendl7=l"]¥ 

[jump storage="xmaseve—credit•ks" target=*ending02]¥ 


シナリオ例 4 行目の [ eval ] で指定されている 「 sf . aendl 7」 がシステム変数で 
あり、 aendl 7 というシステム変数を「1」にしています。同様の記述をしてお 
けば、エンディングを見たときにそれぞれの変数が「1」になり、見ていない 
エンディングは「0」のままなので、あとは、エンディング•リストでそれぞ 
れのシステム変数をチェックして [ if ] による条件分岐を書けば、完成です。 




:.苁明任::1.連V。思し:. hi す 


二•.■フイ 1 ル画面 I . 厂居.. f > 
e. 支配....いて:，.'..ツセージを見る 
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9-3 エンデイング • リストを作る 


r 藏， 




*memories 

; [position 丄 ayer=messageO color=0xFF0000 opacity=0 left=0 
top = 0 width=640 height = 480 marginL = 3 5 marginT = 3 0 
marginR=35 marginB=25]¥ 


[position layer=messagel color=0xFF0000 opacity=0 left=0 
top = 0 width=64 0 height = 480 marginL = 3 5 marginT = 3 0 
marginR=35 marginB=25]¥ 

[p 丄 aybgm storage="piano"]¥ 

[scenechange storage 二 ’• title2" ] ¥ 


[layopt layer=messagel page=fore visible=false]¥ 

[layopt layer=messagel page=back visible=false]¥ 
[er]¥ 

[current layer=messageO]¥ 

[backtxtclear]¥ 

[layopt 丄 ayei:=messageO page=fore visible=fa 丄 se]¥ 
[delay speed=nowaitJ ¥ 

[font color=0xFFFF00]¥ 

お客様とお連れ様のイブの思い出は以下の通りです。 

[locate x=80 y=30] 【font color=0x00FFFF]Alive Ending 
[locate x=380 y=30][font color=0xFF0000]Death Ending 


[font size=14 color=0x 66666 b]¥ 

[locate x=20 y=60] [ch text:’ •永遠に . （最終話）"] 


[if exp= n sf.aend01 = = l M ][locate x=2 0 y=6 0] [font 

color=OxFFFFFF] [ch text=" 永遠に . （最終話） 

”] [font color=0x666666][r][endif]¥ 

[locate x=20 y=75] [ch "ホワイトイブ （最終話）"] 

[if exp="sf.aend02 = = l w ][locate x=2 0 y=7 5] [font 

color=OxFFFFFF] [ch text: "ホワイトイブ （最終話） 

.， ][font color=0x666666] [r] [endif] ¥ 

[locate x=20 y=90] [ch text= "ここはどこ？ぼくは誰？（最終話）"] 
[if exp="s f.aendO 3 ==1 M ][locate x=2 0 y=9 0] [font 


color=OxFFFFFF] [ch text: •， ここはどこ？ぼくは誰？（最終話） 


”] [font color=0x666666][r][endif] ¥ 

[locate x=20 y=105] [ch text= "帰りたい故郷へ （第七話）"] 


[if exp= w s f.aendO4 ==1 "][locate x=2 0 y=l0 5] [font 
color = OxFFFFFF ] [ch text= ••帰りたい故郷へ （第七百舌） 


"][font color=0x666666] [r] [endif]¥ 

[locate x=20 y=120] [ch text=_ •ロザリオの少女 （第六 E 舌）"] 


####### 
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その他の機能 


設藤*;掛■翻瓣纖_激驗纖洛滞_繼織禪'纖銘纖纖澡德: 


111111 iiiiaiiisiiiii 


[if exp="sf.aend05 = = l"][locate x=2 0 

color = OxFFFFFF] [ch text = "ロザリオの少女 
"][font color=0x666666][r][endif]V 
[locate x=20 y=135] [ch text = "彼女の神性 
[if exp="sf.aendO6 二 =1"][locate x=2 0 
color = OxFFFFFF] [ch text = "彼女の神性 
"][font color=0x666666][r][endif]V 
[locate x=20 y=150] [ch text 二"一人の力は弱くても 
[if exp 二 , ’ sf ♦ aend07 = 土 1 "][loca 匕 e x=2 0 

color=OxFFFFFF] [ch text=” 一人の力は弱く て 
”] [font color=0x666666][r][endif]V 
[locate x=20 y=165] [ch text = "虚ろな日々 
[if exp=''sf . aend08 = = l"][locabe x=2 0 
color = OxFFFFFF] [ch text = "虚ろな日々 
__] [font color=0x666666] [r] [endif]V 
[locate x=20 y=180] [ch text = "そんなものさ 
[if exp="sf.aend09 = = l"][locate x=2 0 

color=OxFFFFFF] [ch text = "そんなものさ 
”][font color=0x666666][r][endif]V 
[locate x=20 y=195] [ch text= " 新しし‘恋人 
[if exp="sf.aendl0 = = 1"][locate x=2 0 
color = OxFFFFFF] [ ch text = "新しい恋人 
__ ] [font color=0x666666 ] [r] [endif ]¥ 

[locate x=20 y=210] [ch text= "眠っている君へ 
[if exp="sf.aendl1 = = 1"][locate x=2 0 
color=OxFFFFFF] [ch text 二 " 眠っている君へ 
"][font color=0x666666][r][endif]V 
[locate x=20 y=225][ch text 二 " 魔導 _ 志願 
[if exp="sf.aendl2==l"][locate x=20 
color=OxFFFFFF][ch text=" 魔導#志願 
__] [font color=0x666666] [r] [endif]V 
[locate x=20 y=240] [ch text= "白い夜明け 
[if exp="sf.aendl3 ==1 "][loca :e x=20 

color=OxFFFFFF] [ch text= " 白し、石[明け 
•■] [font color=0x666666] [r] [endif ]、： 

[locate x=20 y=255] [ch text= " 冬嫌し ’ 

[if exp="sf.aendl4 ==1 "][loca :e x=20 
color=OxFFFFFF] [ch text= "冬嫌い 


才の少女 


x = 20 


1 力は弱くても 
匕 e x=2 0 
) 力は弱くても 


x=20 


x=20 


ものさ 


x=20 


x=20 


x = 20 


y=120][font 

(第六話） 

(第六話）"] 
y=l 3 5 ] [font 
(第六話） 

(第六話）"] 
y=15 0 ] [font 
> (第六話） 

(第六話）"] 
y=165][font 
(第六話） 

(第五話）"] 

y=l 8 0 ] [font 

(第五話） 

(第四話），，] 

y=195][font 

(第四話） 

(第四話）"] 
y=2 10 ][font 
(第四話） 

(第四話）"] 
y=22 5 ] [font 
(第四話） 

(第四話）"] 
y=2 4 0 ] [font 

(第四話） 

(第三話）"] 

y=2 5 5 ] [font 

(第三話） 


















9-1 スキップ状態を制限する 


KAG 


” ][font color=0x666666][r][endif] ¥ 

[locate x=20 y=270] [ch text :" 消えない偈痕 （第三話 ）"] 

[if exp= n s f.aendl5 = = l"][locate x=2 0 y=2 7 0 ] [font 

color=OxFFFFFF] [ch tex い，■消えない傷痕 （第三話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x=20 y=285] [ch text = "あたしのヒー ロ ー ( 第二話 ）"] 

[if exp="sf.aendl6==l"][locate x=20 y=285][font 

color=OxFFFFFF] [ch text 二 " あたしのヒーロ - ( 第三話） 

color=0x666666][r][endif] ¥ 

[locate x=20 y 二 30 0] [ch text=’’ 守ってくれてありがとう（第二話 ）"] 
[if exp="s f.aend17 ==1"][locate x = 2 0 y=3 0 0] [font 

color=0xFFFFFF] [ch text= ，，守ってくれてありがとう（第二話 ） "][font 
color=0x666666][r][endif]¥ 

[locate x=20 y=315] [ch text = "雪だるまになった朝 （第二話 ）"] 

[if exp 二 ” sf • aendl8 二 =1 _， ][locate x=2 0 y=315 ] [ font 

color=0xFFFFFF] [ch text = "雪だるまになった朝 （第二話 ）”] [font 

color=0x666666][r][endif]¥ 

[locate x=20 y=330] [ch text : "来年こそは （第一話 〉"]¥ 

[if exp="sf.aendl9 = = l"][locate x=2 0 y 二 330] [font 

color=0xFFFFFF] [ch text = "来年こそは （第一話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x=320 y=60] [ch text :" 贖罪 （最終話 ）"] 

[if exp 二 " sf • dendOl 二 =1 ，， ][locate x = 32 0 y=60 ] [ font 

color=0xFFFFFF] [ch text = "贖罪 （最終話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x=320 y=75] [ch text = "人嗅いベッド （最終話 ）"] 

[if exp="sf.dend02==l"][locate x=320 y=75][font 

color=0xFFFFFF] [ch text =" 人嗦いベッド （最終話 ）"] [font 

color 二 0x666666][r][endif]¥ 

[locate x=320 y=90] [ch text = "死者が扉を叩く 時 （第五話 ）"] 

[if exp 二 ’ , sf . dend03 = = l ” ][locate x=320 y=90 ] [ font 

color=0xFFFFFF] [ch text= H 死者が扉を叩く 時 （第五話 ）"] [font 

color=0x666666][r][endif]¥ 

[locate x=320 y=105] [ch text= ”山羊の仮面の呪い （第五話 ）"] 

[if exp="sf.dend04 = = l"][locate x = 320 y=l05] [font 

color=0xFFFFFF] [ch text= "山羊の仮面の呪い （第五話） "][font 

color=0x666666][r][endif]¥ 

[locate x=320 y=120] [ch text = "祭壇の上の君 （第四話 ）"] 


_______ 
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の夜明け 

x = 320 


の井戸 


たも同じ 

: e x = 3 2 0 

じ 


い続き 


[if exp= n sf.dend0 5 = = l"][locate 
color=OxFFFFFF] [ch text = "祭壇の上君 
color=0x666666][r][endif]¥ 

[locate x=320 y=135] [ch text 二 " 偽り 
[if exp 二 ” sf • dend06 二 =1 __ ][locate 

color=OxFFFFFF] [ch text =' •偽りの夜日南け 
color=0x666666][r][endif]¥ 

[locate x=320 y=150] [ch text =” 死者 
[if exp 二 " sf • dend07 = = l，'][locate 

color=OxFFFFFF] [ch text =" 死者の井戸 
color=0x666666][r][endif]¥ 

[locate x=320 y=165] [ch text =" あな 
[if exp="sf.dend08==l"][loca 
color=OxFFFFFF] [ch text 二，，あなたも同 
color=0x666666][r] [endif] ¥ 

[locate x=320 y=180] [ch text = "悪夢 
[if exp="sf•dend09==l”][locate 
color=OxFFFFFF] [ch text = "悪夢の続き 
color=0x666666][r][endif]¥ 

[locate x=320 y=195] [ch text= ”あな柃もォォカミに 
[if exp= " sf . dendlO = = l"][locat: 
color=OxFFFFFF] [ch text 二"あなたも才 
color=0x666666][r][endif]¥ 

[locate x=320 y=210] [ch text = "逃れ擎ぬ運命 
[if exp 二 ,, s f . dendl1 ==1 "][locat 

color=OxFFFFFF] [ch text = "逃れ得ぬ運命 
color=0x666666][r][endif]¥ 

[locate x=320 y=225] [ch text 二 ” 寒さ O 中で 
[if exp="sf.dendl2==l"][locat 
color=OxFFFFFF] [ch text =" 寒さの中で 
color=0x666666][r][endif]¥ 

[locate x=320 y=240] [ch text = ，•ついてきたもの 
[if exp="sf•dendl3 二 =1 ” ][locat 
color=OxFFFFFF] [ch text= " つし、てきた 
color=0x666666][r][endif]¥ 

[locate x=320 y=255] [ch text= ，，痴話嗱嘩 
[if exp="s f.dendl4 = = l"][locat 
color=OxFFFFFF] [ch text 二 " 痴話喧嘩 


x=320 y=120][font 

( 第四話 ） H ] [font 


( 第四話 ）" 
y=135][font 
( 第四話 ）"] [font 


( 第三話 ）"] 
x = 3 2 0 y=15 0] [font 

( 第 S 話 ）"] [font 


( 第二話 ）"] 
y=165][font 
( 第二話 ）"] [font 


( 第二話 ）"] 
x=3 2 0 y=180] [font 

( 第二話 ）"] [font 


e x=3 2 0 

カミに 


e x= j 2 0 


( 第二話 ）"] 
y=l9 5] [font 
( 第二話 ） H ] [font 

( 第二話 ）"] 
y=210][font 
( 第二話 ） '•] [font 




( 第二話 ）"] 
x=320 y=225][font 

( 第二話 ） ,r ] [font 

( 第一話 ）"] 
x=3 2 0 y=2 40] [font 

( 第一話 ） "][font 


b x=320 


( 序章 ）”] 
y=255][font 
( 序章 ） "][font 


f 
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color=0x666666][r][endif]¥ 

[locate x=320 y=285] [ch text= n 各種一発死 
[if exp 二 " sf.dendl5 = = l"][locate x=320 

color=OxFFFFFF] [ch text 二 " 各種一発死 
color=0x666666][r][endif]¥ 

[locate x=320 y=300][ch text= M 各種一発死 
[if exp="sf.dendl6==l"][locate x=320 
color=OxFFFFFF][ch text=" 各種一発死 
color=0x666666][r][endif]¥ 

[locate x=320 y=315][ch text=" 各種一発死 
[if exp="sf.dendl7==l"][locate x=320 
color=OxFFFFFF] [ch text 二 ,, 各種一発死 
color=0x666666][r][endif]¥ 

[locate x=320 y=330] [ch text= M 各種一発死 
[if exp=”sf.dendl8= 二 1 ” ][locate x=320 
color=OxFFFFFF] [ch text= n 各種一発死 
color=0x666666][r][endif]¥ 

[resetfont]¥ 

[locate x = 44 0 y=4 0 0][link target:*rinish—memories 

color=0xFF0000] メニュー t こ戻る [endlink]¥ 

[backlay]¥ 

[layopt layer=messageO page=back visible=true]¥ 

[scenechange4 storage 二 " title2"]¥ 

[current layer 二 messageO]¥ 

[s] 

/ 

*finish_memories 
[fadeoutbgm time=1000]¥ 

[backtxtclear]¥ 

[scenechange storage 二 " tit lei _■] ¥ 

[er]¥ 

[wb] ¥ 

[jump target=★option2] 

[s] 


( 第七話 ）"] 
y=2 8 5] [font 
( 第七話 ）"] [font 

(第六話）"] 
y=3 00 ][font 
( 第六話 ）"] [font 

( 第五話 ）"] 
y=3 15 ][font 
( 第五話 ) "][font 

( 第三話 ）"]¥ 
y=3 3 0 ] [font 
( 第三話 〉 "][font 
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市販ゲームの中には選択肢に制限時間が設けられているものがありますが、 
KAG では『制限時間つき選択肢』という概念はなく、 [wait 】 タグと [jump] タグ 
を組み合わせることで非常に簡単に実現でき泶す。 

參シナリオ例 


[nowait] ¥ 

[locate y=365] ¥ 

[link target=*scene01 ] 選択肢 A [endlink] 

[link target=*scene02] 選択肢 B [endlink] 

[link target=*scene03] 選択肢 C [endlink]¥ 

[endnowait]¥ 

[wait time= 制限時間 ] ¥ 

[jump target= ★ 時間切れのページへ ] ¥ 

[s] 

今までは選択肢の終わりには [s] タグをつけ ¬ 
が、 選択肢の次に [wait 】 タグを置くことによて 
時間制限をつけて停止させることができまづ 
( 単位ミリ秒）を過ぎるとスクリプトは下の行 
これで、制限時間つきの選択肢が出来ました。 

r 強制的に動きを止めていました 
て、ここでスクリプトの処理を 
• 。この [wait ] で指定された時間 
にある [jump] タグを実行します。 

ただしこの例では、何秒待ったら時間切れ 
で、前景レイヤーにメーターのような画像を衰 
ションを利用します。画像を準備さえすれば、 
ろいろな形で残時間が表現できます。 

になるのか分かりません。そこ 

E 示したユニバ ' ーサル.トランジ 
円形やバーメーターのようない 

參準備するファイル 


残時間のあるメーター画像ファイル limit 
残時間のないメーター画イ象ファイル limit 
トランジ シヨ ンのためのルール.ファイル 

:01 .png 

: 〇 2 .png 

meter.png 
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制限時間つき選択肢を作る I 




•シナリオ例___ 

1 [layopt layer=0 page=fore visible=truej¥ 

2 [image storage^ 11 limitOl .png"layer=0 page=fore] ¥ 

3 [nowait]¥ 

| 4 [history output=false]¥ 

5 [locate y=300]¥ 

6 [link target=*s01] 選択肢 A [endlink] 

7 [link target=*s02] 選択肢 B [endlink] 

8 [endnowait]¥ 

9 [backlay]¥ 

10 [cancelskip]¥ 

| 11 [clickskip enabled=false]¥ 

12 [image storage= M limit02.png" layer=0 page=back]¥ 

13 [trans rule="meter.png" time=10000 vague=10]¥ 

14 [wt]¥ 

15 [jump target=*timeout]¥ 

16 ; --- - 

17 *s01 

18 [stoptrans] ¥ 

19 [freeimage 丄 ayer=0]¥ 

20 [clickskip enabled=true]¥ 

21 [ct]¥ 

22 選択肢 A が選択されました。 [1] 

23 ; -- 

24 *s02 

25 [stoptrans]¥ 

26 [freeimage layer=0]¥ 

27 [clickskip enabled=true]¥ 

28 [ct]¥ 

29 選択肢 B が選択されました。 [1] 

30 ;-- 

31 *timeout 

32 [ct]¥ 

33 [freeimage 丄 ayer=0]¥ 
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34 [clickskip enabled=true] ¥ 

35 [s] 


《1〜 2 行目》 

まずは前景レイヤー0のフォアグラウ 
riimitOl.pngJ というメーター用画像ファイル 
レイヤー0に選択肢を表示します。 


y ドを可視状態にし、そこに 
を表示し、続いてメッセージ • 


«10~11行目》 

続いて 「 limit 02. png 」 という残時間の存在 
ヤー1の裏画面に読み込み、 「 meter . png|J 
「 limitOl . png 」 から riimit 02 .pngj へトランジ 
時間内に選択肢を選んだ場合はジャンプ先+ 
を用い、強制的にトランジシヨンを停止しま^ 
選んだのにメーター • ファイルが稼動し続け 
ります。 


しない画像ファイルを前景レイ 
というルール • フアイルで 
レヨンを行なっています。 

ラベルで [ stoptrans ] というタグ 
これを行なわないと選択肢を 
4ことになり、おかしなことにな 


《26、33行目》 

また、 [ freeimage ] というタグは、指定された 
に解放します。この場合はメーター関係の画像 
一0を空にしています。このように使い終えた 
くことで、余分なメモリを消費することもなく: 
用しようとした時に前のデータが残っているこ 


メーター. ファイルと同時に背景画像も表ホする場合は、メーター.ファイ 
ルを透明度情報を持つ画像で作らないといけません。 

アンチェイリアスが掛かっていないシンプ >4な形状のメーターを利用する場 
合は、 [ image ] タグの key 属性を利用します。 

key 属性は、透明にしたい色を 「 key = OxRI ^ GGBB 」 で指定すると、その色 
が透明になる効果を持ちます。 rkey = adaptj と指定すると、画像の最上部の 
ラインで最も多く使われている色ピクセルの色が自動的に抜き色となります。 


前景レイヤー0の内容を強制的 
データをクリアして前景レイヤ 
らきちんと元の状態に戻してお 
なり、次に前景レイヤー0を利 
ともなくなります。 
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•記述例_ _ _ 

[image storage 二 " meter.png" layer=0 page=fore 
key=0x000000]¥ 


ただし、上の方法でアンチエイリアスが掛かっている画像の背景色を抜こう 
とすると縁が汚くなります。このような場合は、「吉里吉里2」に付属する画 
像フォーマット • コンバータを使うといいでしよう。 

画像フォーマット • コンバータは rkr 2_218 r 2¥ kirikiri 2¥ graphconvJ の中に 
入っている 「 krkrtpc . exe 」 です。 

まず、 Photoshop の PSD ファイルなどの透過背景を持つ画像を準備し、そ 
れを画像フォーマット • コンバータにドロップするだけで、 KAG の前景レイヤ 
一に読み込むことのできる画像が生成されます。 

通常利用する場合、「透過情報を持った画像の出力形式 ( F )」 の部分は「《 
チャンネル付 PNG (メイン+マスク）」で構いませんが、 CD での配布を前提 
としており、サイズは小さくなくてよいから展開速度を上げたいという場合は 
32 bitBMP (メイン+マスク）を選びましよう。 








懲 IP 纖綱 


m 










Flash * や Premiere * などのソフトが使える 


^は、オープニングに動画やアニ 


メーションなどのムービーを入れたいと思う七しょう。 

KAG では専用のタグが用意されており、 ^ PEG 形式のムービーと SWF 形式 
の Flash フアイルを再生することができます。 


•シナリオ例 


*start 

[video visible=true left=0 top=CM 
[playviaeo storage^"logo.mpg"]¥ 

ip 丄 ayvideo storage 二 " Love•swf"]¥ 

[wv]¥ 

i^idth=640 height=480] ¥ 

「 krkr . eXe 」 と同じ場所に Flash ファイルそ 
じ場所に 「 krflash . dll 」 プラグインを 、 MP 

r 再生するには 「 krkr . eXe 」 と同 
EG などの動画を再生するには 


「 krmovie . dll 」 プラグ インを 置く必要が あり未す。また、 「 firstks 」 の冒頭な 
どでプラグ インをロー ドする 必要が あります。 


•記述例 


[loadplugm module="krmovie.all"]¥ 
[loadplugin module="krflash.dll"]^ 
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右クリツク動作のカスタマイズ 


づ 


「吉里吉里/ KAG 」 のデフォルトの機能では、マウスを右クリックした場合 
メッセージ•レイヤーが非表示になります。しかし、この右クリックで固定の 
サブルーチンを呼ぶ動作を定義することができます。 



画面例 1 



これは KAG 3 のサンプルとして付属しているプラグインの 一つで ある 
f ¥ kag 3¥ kag 3 plugin ¥ sample¥j 内の 「 rclick - tjs . ks 」 と 「 rdick _ tjs _ test . ks 」 を 
使ってみた結果、市販のゲームのように、右クリックで表示されるメニューに 
おいてゲームの進行データをセーブしたり口ードしたりできるようになった例 
です。 

やり方ですが、「 rclick _ tjs _ test . ks 」 内に記述されているサンプル • シナリオ 
の必要な部分を「 first . ks 」 にコピーし、「 rclick _ tjs . ks 」 ファイルを scenario フ 
オルダにそのままコピーするだけです。 


「 rclick _ tjs _ test . ks 」 内に記述されていた 「 ©call storage = M rclick _ tjs . ks n tar - 
get =* rclick 」 の部分で 「 rclick _ tjs . ks 」 という外部サブルーチン • ファイルを 
呼び出し、上のような右クリックメニューを実現しています。 
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画面例 2 


サンプルの『紫月』に搭載されている右ク U | ックによるマップ表示です。 
:れも同様に、メインシナリオ側から 「 ©call storage =’’ rclick . ks ’’ target = 
^ rclickj という記述で 「 rclick . ks 」 という名南のサブルーチン.ファイルを呼 
び出しています。 


また、もっとも基本的な右クリック•メニニ 
KAG システム ■リ ファレンス 内に記述されて 
合、 ラベルが 「★ subl 」 なので、 first . ks などの メイン シナリオからは 「@call 
storage = M rclick . ks ,1 target =* sublj というように記述して呼び出します。 


- を作るための 「 rclick.ks 」 は 
M るのでご覧ください。この場 









9-7 zoom プラグインの麵 

獠纖 》 sii» mm 

_ 錐###嫌 



背景や前景に表示した画像を拡大したり縮小したりするには、 「zoom ブラ 
グイン」を使います。このプラグインは 「KAG3¥KAG3plugin¥zoom¥sce- 
nario¥j の中にある 「zoom.ks」 が本体です。まずは、これを自分のプロジヱ 
クト. フォルダ 下部の scenario フォルダに コピーしておきましよう。 

続いて、シナリオの書き方ですが、 zoom プラグインを使いたいプロジェク 
卜の 「first.ks」 の先頭行に、以下のように記述します。 

•記述例 

@cal 1 storage 二 ” zoom.ks" 


これも前述の 「sta£froll.ks」 と同様、サブルーチン形式で提供されており、こ 
のサブルーチンを呼び出すことで、以下の4つの zoom 用タグが定義されます0 


編 ! 

base レイヤーの画像をズームする 


前景レイヤーの画像をズームする 

agfe 4 

base レイヤーの画像のズーム終了を待つ 


•シナリオ例 

Iimage storage= M testOl.bmp" 丄 ayer=base page=tore]¥ 

まずは背景をズームオフ。 [1] 

Limage storage="black.bmp"layer=base page 二 fore]¥ 

[bgzoom storage="test01.bmp H bgstorage="testOl.bmp" sl=0 
st=0 sw=640 sh=480 dl=320 dt=240 dw=0 dh=0 time=3 000 
sccel=0]¥ 

Lwbgzoom]¥ 

今度は前景の立ち絵をズームイン。 [1] 

[laycount layers=l] ¥ 

[rgzoom storage= n akira,png"layer=0 mode=transp sl=320 
st=480 sw=0 sh=0 dl=160 dt=0 dw=320 dh=480 time=3000 
sccel=0]¥ 
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:七ずは竹！; I ： をズームオフ。 

⑸空はボ n ; u r) 立ら絵をスー太イン q .. 

'レ）とズ…ムイン 

もっとむっとズームイン,… 

むっともっともっと,人きくできるのですが 
やめておき : t すり，.: ++.: 


[wfgzoom] ¥ 

もっとズームイン。 [1] 

[rgzoom storage= H akira.png"layer=0 mode=transn sl=160 
st=0 sw=320 sh=480 dl=0 dt=-240 dw= 640 dh=960 time=1000 
sccel=0]¥ 

[wfgzoom] ¥ 

もっともっとズームイン。 [1] 

[fgzoom storage 二 " akira .png 11 layer=0 mode 二 transp sl=0 st=~ 
240 sw=640 sh=960 dl = -320 dt =-720 dw=1280 dh=1920 

time=1000 sccel=0]¥ 

[wfgzoom] ¥ 

もっともっともっと大きくできるのですが、この辺でやめておきます。 [1] 









「 KAG 3」 には、前景などに雨や雪を降らせるプラグインが準備されていま 
す。これらのプラグインは rKAG 3¥ KAG 3 plugin ¥ j 内にある 「 rain 」 と 「 snow 」 
フォルダに格納されているので、利用する場合はこれらのプラグインを自分の 
プロジェクト， フォルダに コピーして おきます。 

各プラグインフォルダ内の image フォルダに含まれている画像は 「 feimage 」 
や 「 image 」「 other 」 などのフォルダへ、そして scenario フォルダ内に含まれ 
ている ks ファイルは scenario フォルダにコピーします。 

rstaffrollj プラグインや 「 zoom 」 プラグインと同様、まずはプロジェクトの 「 first . ks 」 
の先頭行にプラグインをロードするためのサブルーチン呼び出しコマンドを記述します。 


•記述例 


©call storage: 
©call storacre: 


"snow.ks" 
"rain.ks" 


雪と雨の両方のプラグインを使いたければ、上の記述例のように両方記述 
する必要があります。 

♦シナ IJ 才例 


[image storage="test 02 .bmp" layer=base page=fore]¥ 
では、雪を降らせます。 [1] 

@snowinit forevisible=true backvisible=i:alse 
しばらく待っていると上のほうから雪が降ってくると思います。 [1] 
細かい調整は snow• ks を変更することで可能になります〇 [ 1 ] 

では止めてみましよう。 [1] 

@snowuninit 
止みました。 [1] 

では、雨を降らせます。 [1] 

@raininit forevislble=true backvisible=raise 
どうですか？ 雨が降っていますか？ [1] 

雨の振り方は rain.ks を調整することで変更が可能です。 [1] 

では止めてみましよう。 [1] 

@rainuninit 

止みました。 [1] _ _ _ 


S 雞議義 

iilW 
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_______ 
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雪•爾プラグインの利用 :;; 





をグせラはフアロルし 
ーラまプて•フブォま 
ビブしのい才像をフし 
コと作雨つリ画方•一 
のる動とにナと両トビ 
像れは雪ンシルのクコ。 
画忘ン。イずイル H にぅ 
しイんグ必アイジダよ 
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各種カスタマイズの方法や、バージヨン情報ダイ 
ア〇グの作り方など、作品が完成に近づいた5理 
解しておきたし饑能を中心に解説します。 
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«ジリ_スに向けて 


■セープ • データの ロー ド画面 


ここでは、 一般のゲームな どで メニューか_ 
専用の データロード 画面を作ってみます。利用 
に使った [ link ] タグと、変数を表示する [ emb ] ふ 

參シナ U 才例 


[link exp="kag.restoreBookMark(0)"]¥ 

[emb exp= kag.getBookMarkPageName (0) " ] ¥ 
[endlink]¥ 


[ emb ] タ グで「 PageName ⑼」という栗の 七 
を [ link ][ endlink ] でく くり、クリックされたら 
ブ • データをロー ドするという意味です。 


KAG の菜データには「0」から「998」まで 
目の菜には「0」、2番目の菜には「1」、3番^! 
ように番号が振られています。このため上記^ 
読み込む」という意味になります。 


め番号が与えられており、1番 
は「2」、4番目は「3」という 
|例は「1番目の セーブデータを 


:れを元にしてロード画面を作ると、以下の 


參シナリオ例 


*datal 〇 aa 
[ct]¥ 

[nowait] V 
[locate x=40 y=20] 再開する呆を選んでく 
[style align 二 center] ¥ 

[1ink exp="kag.res 

exp 二 " kag. getBookMarkPageName (0) 11 ] 

[1ink exp= ” kag.res 

exp= H kag.getBookMarkPageName(1)"] 

[link exp= 11 kag . res 

exp=" kag. getBookMarkPageName (2 ) 11 ] 

[link exp="kag.res 


「ロード」を選ぶと表示される 
するタグは選択肢を配置する時 
グの2つです。 


ーブ•タイトルを表示し、それ 
「 BookMark ⑼」というセー 


ようになります。 


ださい。 

toreBookMark( 0 )"][emb 
[endlink] 

toreBookMark(1 )"][emo 
[endlink] 

toreBookMark ( 2 ) ，， ] [ emb 
[endlink] 

toreBookMark(3)"][emb 



















タイトルへ戻る 


exp=" kag. getBookMarkPageName ( 3 ) " ] [endlmk] 

[link exp="kag•restoreBookMar] 

exp="kag.getBookMarkPageName (4) " ] [endlmk] 
[style align=default]¥ 

[locate x=400 y=3 60][link target = *menu ] メ 

[endlink]¥ 

[endnowait]¥ 


[link] タグで表示される矩形の色を変えた I ゝ場合は、以下のように記述します。 


この color 属性は [link] タグを使ったすべての選択肢に使えるので、工夫をす 
れば面白 t 、選択肢を作ることができるでしょう。 
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マウス • カーソルのカスタマイズ 



また、形を変える場合は、 「PageBreak_a.png」 や 「LineBreak_a.png」 を書 
き直す必要があります。 

この2つのファイルは、 24X24 ドットの小さな画像が横に16個並べられた 
16コマのアニメーションになっているので、 24X24 のサイズの画像を16個作 
って、それを横に並べれば、オリジナルの記号が作れます。 

• LineB 「 eak_a.png 例 

' ノ Ivv ダ 勢 r ぎ•梦 S • い ' 


• PageBreak—a.png 例 



■ マウス • カーソルのカスタマイズ 


吉里吉里で制作した作品では、オリジナルのマウス.カーソルが使えます。 
オリジナルのカーソルには 「アニメーション •カーソル」 （. ani ) と 「一般の 力 
ーソル」 （.cur) の2種類が指定できます。 


まずは披張子が 「cur」 か rani」 のファイルを作ります。 Windows の Cur¬ 
sors フォルダ内にたく さん入っているので、初めての人はこちらから適当なも 
のを選ぶとよいでしょう。自分で作りたい人は専用のソフトを使うか、インタ 
ーネットで配布されているフリーのマウスカーソル • エディタなどを手に入れ 
て、それで作ります。 

cur ファイルが手に入ったら、それを template フォルダ内の other フォルダ 
に コピーし ます。 

続いて、 「Config.tjs」 の以下の部分を開きます。 


// ♦ マウスカーソル 

//マウスカーソルを指定します。マウスカーソルは cr で始まるマウスカ 
//ーソル定数 （ 吉里吉里2 SDK Help 参照）か、マウスカーソルフ 
//ァイル名である必要があります0アニメーションマウスカーソルも指定 
//できます。 

//マウスカーソル定数を指定するときは、 cursor タグで指定するように 
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IMJ — スに向けて 

參 

m 

u 先頭に & をつける必要はありません。マウスカーソルファイル名を指定 
// する場合は "" （ダブルクオーテーシヨン）でく くってください。 
;cursorDefault = crArrow ； // 通常 4> マウスカーソル 
; cursorPointed = crHandPoint ; //リンクなどをポイントしたとき 
；cursorWaitingClick = cr Arrow; // クリック待ちの時 
;cursorDraggable = crSizeAll; // メツセ——ジレイヤをドラッグ可 

能なとき 

下部の4行を見れば、吉里吉里で利用されているマウス•カーソルは4種類あ 
ることが分かりますが、通常時とクリック待ちのときに同じファイルが指定され 
ているので、実質的には3種類になります。なぜ通常時とクリック待ちのときに 
同じカーソルを指定しているのかというと、この2 つの 状態はお互いに小刻みに 
入れ替わることが多ぐ別のカーソルを指定するとチラチラしてしまうからです。 

この部分に、以下の記述例のようにオリジナルのカーソル名を指定します。 
ファイル名は拡張子まで指定し、「"”」（ダブル‘クオーテーション）でくくっ 
ておくと、間違いがありません c 

; cursorDefault =" original 01 .cur r, ; // 通常のマウスカーソノレ 
； cursorPointed =“original02 • cur n ; // リンクなどをポイントしたとき 
； cursorWaitingClick 二，， original 01 • cur ，， ； // クリック待ちの時 
； cursorDraggable =original03 .cur 11 ;// メッセーンレイヤをトフ 

ッグ可能なとき 

これでオリジナルのカーソルが使えますが、これとは別にゲー厶*シナリオ 
の中で一時的にカーソルを変更したい場合は [ cursor 】 タグを用います。 

•タグ記述例 

[cursor defauit= "originalOl• cur" pomted="origmal02 .cur" 
click="original01.cur" draggable 二 " Driginal03.cur"]¥ 


[ cursor ] タグの属性は、それぞれが 「 Config $ s 」 の 4 行部分に該当します。 





ダイア□グのカスタマイズ 

####### 


ダイア□グのカスタマイズ 


菜を扶んだり、たどったり、ゲームを終了したりするときに表示される「は 
い/いいえ」ダイアログもカスタマイズすることができます。 


まずは、基本となる、どのようなダイアログでも常に表示される文字部分を 
変更してみます。 

「 system フオルダ」内の [ YesNoDialog . tjsJ を開き、以下の部分を探します。 


書 YesNoDialog.tjs 例_ 

// Yes ボタン 

add(yesButton = new ButtonLayer(this, primaryLayer)); 

yesButton. caption =" はい"； 

yesButton.captionColor = clBtnText; 

yesButton.width = 70; 

yesButton.height = 25; 

yesButton.top = th + 35; 

yesButton.left = (w - (70*2 + 10) >>1 ); 

yesButton.visible = true; 

// No ボタン 

add(noButton = new ButtonLayer(this / primaryLayer)); 

noButton. caption = "し、し 、^/ 1 ,* 

noButton.captionColor = clBtnText ； 

noButton.width = 70; 

noButton.height = 25; 

noButton.top = th + 35; 

noButton.left = ((w - (70*2 + 10)) >>1 ) + フ〇 + 10; 
noButton.visible = true ； 


ここに記述されている「はい」と「いいえ」がダイアログに表示される文字 
なので、自分の好きなように修正します。ダイアログで「確認」と表示されて 
いる部分は、 「 YesNoDialog . tjsJ の最下部にあります。 
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• Menu.tjs 例 


// Yes か No かはっきりさせる関数 

runction askYesNo(message, captio 

s 

a = " 確認”） 

\ 

var win = new YesNoDialogWin 

dow(message, caption); 

win.showModal(); 


var res = win.result; 


invalidate win; 


return res; 

} 



この「確認」という部分を書き換えれば、度更が適用されます。 

また、これらの基本的な文字以外（たとえば「終了しますか？」などのメ 
ッセージ）は MainWindow . tjs 内で定義されています。 

たとえば、「終了しますか？」というメッセージを変更したい場合は、 Main - 
Window . tjs 内の以下の部分を変更します。 

參 MainWindow.t js 例 


// - 

- onCloseQuery/close 

function onCloseQuery() 

f 


l 

saveSystemVariables ()； 


if(laskOnClose) { super.onCl 

oseQuery(true); return ； 

i 

super. onCloseQuery (askYesNo (" 終了 しますか？"））； 

} 


上記の「終了しますか？」の部分を書き換えれば、変更した文字がダイア 
ログに反映されます。 



メニューのカスタマイズ 



■メニューのカスタマイズ 


メニュー • バーに 表示されている「システム/菜をたどる/菜をはさむ/画 
面」のような親 メニュー、 そしてそれらをクリックすると表示される子 メニュ 
一については自由にカスタマイズできます。 

セーブ ロードを使わない作品の場合、『菜』関係のメニューは表示しておい 
ても邪魔なだけなので、 「 false 」 にしてメニュー•バーから消しておきましよ 


う。 

また、会話がほとんど存在せず、パラメータのみで構成されている「育成シ 
ミュレーションゲーム」のような場合には、メッセージ履歴を表示させても仕 
方がないので、消しておきます。 

選択肢のない短編の電子小説の場合なら、『次の選択肢/未読まで進む』と 
いう メニューは 不要な ので 消しましよう。 


これらは、次の 「 Confit . tjs 」 内の記述を変更することで実現できます。 

參 Config.tjs 例 

//- ナ ニューの奴定 

runetion Menu—visible_config() 

I { 

// メニューの表示/非表示の設定 

// true を指定すると表示され、 false を指定すると非表示になります。 
// メニューに表示するメニュー項目名については Menus. t js を書き換 
// えてください。 

// ♦ メニューバーを表示するか 

// 非表示にすると当然どのメニュー項目にもアクセスできなくなります。 

； menu.visible = true ; 

// ♦ 「システム > メッセージを消す」 

//このメニュー項目を非表示にしてもマウスの右クリックでのメッセージ 
// の非表示は引き続き有効です。 

;rightClickMenuItem.visible 二 true ； 
t 背景だけを見せる必要がなければ f alse に。 

// ♦ 「システム > メッセージ履歴の表示」 

; showHistoryMenuItexn. vi sitae = true ； 
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T メッセージ履歴を使う必要がなければ fal_e に c 
// ♦ 「システム > 次の選択肢 / 未読まで | 

// 進む」 

; skipToNextStopMenuItem.visible = 
t 選択肢がない作品の場合は false に。 

// ♦ 「システム > 自動的に読み進む」 

ス autoModeMenuItem.visible = true; 

// ♦ 「システム > 自動的に読み進むウェ fr 卜」 

； autoModeWaitMenu.visible = true ； 

//♦ 「システム > 前に戻る」 

; goBackMenuItem.visible = true ； 
t 選択肢がない作品の場合は false に。 

// ♦ 「システム > 最初に戻る」 

; goToStartMenuItem.visible = true ； 
t 最初に戻る必要がなければ f alse に。 

// ♦ 「文字表示」 

； characterMenu.visible = true ； 

// ♦ 「文字表示 > 表示速度 > ページ 末 f 
//ユーザがこのメニュー項目を チェック する 
//1 タグが無視されるようになります。 

； chNonStopToPageBreakltertu visible 
// ♦ 「文字表示 > — 度読んだところは」 

; ch2ndSpeedMenu.visible = true; 

// ♦ 「文字表示 > — 度読んだところは > 

； ch2ndNonStopToPageBreakItem. visibjL 
// ♦ 「文字表示 > アンチエイリアス」 

; chAntialiasMenuItem.visible = tru 知 
// ♦ 「文字表示 > フォント」 

; chChangeFon tMenuItem .visible = triiie; 
t フォントをユーザーに変更させたくなけれ ^false に。 
// ♦ 「菜をたどる」 

，•: rest oreMenu .visible = true; 
t 桀を使わない作品の場合は false に。 

// ♦ 「呆をはさむ」 


峰む」または「次の選択肢まで 


true ； 


で一気に」 
と、 

\= true ； 


ページ末まで一気に」 
e = true ； 
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メニューのカスタマイズ 



； storeMenu.visible = true; 
t 呆を使わない作品の場合は false に 0 
// ♦ 「画面」 

； displayMenu.visible = true; 
t 画面の表示サイズを変更させたくなければ false に。 

| // ♦ 「ヘルプ」 

; helpMenu.visible = true ； 
t ヘルプがない作品の場合は false に 0 
// ♦ 「ヘルプ > 目次 . • .J 

； helpIndexMenuItem.visible = false; 

// ♦ 「ヘルプ > このソフトについて .. .J 
'•helpAboutMenuItenuvisible = false; 

// ♦ 「デバッグ」 

;debugMenu.visible = true; 

t リリース前に必ず false に戻しておぐ。 ___ 

「 ConfiUjs 」 を書き換えた場合は、「吉里吉里」を再起動しないと変更が適 
用されないので、注意してください。 

また、 system フォルダ内の 「 Menu . tjs 」 を直接書き換えることによってメ 
ニューに表示ざれている言葉を変更できます。 

たとえば、 

menu.add(this. systemMenu = new KAGMenuItem(this , "ンスアム 

(&S> 0, false)); , : __ 

の行の「システム」という部分を「環境設定」のように変更すれば、「吉里吉 
里」のメニューに反映されます。 

メニュー • コマンドを直接メニュー•バーに表示したい場合は、 [ MainWin - 
dow . tjs 」 を書き換えなくても TJS スクリプトを書けば可能です。 「 firstks 」 の 
先頭などに、以下のような記述をします。 







驂 _ # _ # _ 


LMJ —スに向けて 
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m 

#| . 

參シナ U 才例 





Liscnpt] i 

kag.systeraMenu.remove(kag.skipTo 晦 xtStopMenuItem>; 
kag.menu.insert(kag.skipToNextSto 卜 Menultem,1 )； 

[endscript] 


2 行目で「次の未読/選択肢まで進む」と+ゝうメニュー • コマンドを 「シス 
テム」の子の部分から外し、3行目で直接メ |ニュー•バーに表示しています。 


上の例では、「次の未読/選択肢まで進む f を変更するため 「 kag . skip - 
ToNextStopMenuItem 」 という定義名を使っていますが、各メニュー • コマン 


ドがどのような名前で定義されているかは「 M + u . tjs 」 を見て研究してください。 



「このソフトについて」のような情報ダイアログを作るには、 Config . tjs の 
該当部分を以下のように設定します。 


// ♦ 「ヘルプ > 目次...」 

; helpIndexMenuItem.visible = true; 

// ♦ 「ヘルプ > このソフトについて .. ..1 
； heloAboutMenuItem•visib 丄 e 二 true; 
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// ♦ 「ヘルプ〉このソフトについて」を選択したときにでる 
//ウィンドウの表示領域のサイズ 

// このメニューを選択すると about.ks がそのウィンドウ内で実行され 

// ます。 

；aboutWidth = 320; // 幅 
；aboutHeight = 200 ； // 高さ 


上の3つの部分の設定が終了したら、 「 aboutks 」 というファイルを作りま 
す。この 「 about . ks 」 は通常のシナリオとほとんど一緒ですが、いくつか制限 
があります。 


• 効果音バッファは1つしか使えない 
• ムービーは 再生できない 
•メッセージ.レイヤーは1つしか使えない 
• メッセージ履歴は表示できない 


上記の点を踏まえて、通常のシナリオを書くような感じで書きましょう。 


•シナリオ例 

*set 

[title name ノこのソフトウェアに ついて，，]¥ 

Limage storage="help.bmp H layer=base page=fore]¥ 
[position left=0 top=0 width=320 height=200 
color=0xffffff opacity=0 marginl=15 margint=15 marginr=15 
marginb=15]¥ 

’ 

[nowait]¥ 

[font size=18]¥ 

ソフト名 

なんとかかんとか 
制作者 

なんとかかんとか 
[style align=nght] 

[link color=0xff 0000 
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exp 二 " System.shellExecute('http : 

/ /www.piass.com/kpc/')" 

hint= "吉里吉里/ KAG の公式サボートサイト"]吉里吉里/ KAG 推進委員会 

[endlink] 


[link target 二 * exit] このダイアログを閉じる [endlink] ¥ 

[endnowait] ¥ 


[s] 


*exit 


©close 


上記の [ link ] タグの例のように exp 属性で| 

丁 System . shellExecute 」 に URL を 


指定しておくと、リンクをクリックしたらブラウザを起動して指定のサイトに 
アクセスするようになります。 

この例は 「 aboutks 」 内だけでなく、一般のシナリオ内でも利用できるの 
で、クリックしたときに指定のホームページにアクセスさせたい場合は上記の 
ように書くとよいでしょう。ただし、 ユーザ 丁の誰もがインターネットへ常時 
接続できる環境を持っているとは限らないのす、多用は禁物です。 


このソフト•ウ1アについて m 

ソフト名 

なんとかかんとか 

制作者 

なんとかかんとか 


吉里吉里/ KAG 推進委員会 

このダイアログを閉じる 





Releaser による実行ファイル化 

纖繼画•應翻■織_纖■: pm 瓣獅!纖獄__篇纖獲^^ ifili ^ 

修馨癰瘳⑩#錐 


Releaser による実行ファイル化 


細かい部分を詰め終わり、プロジェクトが完成したら Releaser を用いてリリ 
ースします。「リリース」は、直訳すると『公開する/発売する』という意味 
ですが、『解放する/手放す』という意味もあります。 

KAG で制作したプロジェクトは、専用の「リリーサー」を使ってリリース 
します。この作業をすることによって、画像やサウンド、シナリオなどのファ 
イルがバラバラにフォルダの中に入っていた状態を、大きな 一つの ファイルに 
まとめることができます。 

この作業を行なうことで、市販のゲームのように、プログラムである実行ファ 
イルが1個、セーブ•データを保存するフォルダが1個、そしてドキュメントが 
1個という、非常にシンプルでカッコいい形態で配布することができるわけです。 

リリーサーを起動したら、リリースしたいプロジェクト • フォルダを指定 
し、アイコンをオリジナルのものに変更すれば、必要最小限の設定は完了です。 
すべての設定が終わったら作成ボタンを押せば、 exe 形式にリリースされます。 



Releaser 
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readme.txt は昔 
は rreadme.docj 
という名前のファ 
イルでやりとりさ 
れていました。と 
ころが Microsoft - 
Word というワープ 
ロソフトの標準拡 
張子が 「 doc 」 に設 
定されてしまった 
ため、 readme.doc 
ファイルをダブル 
クリックすると重 
い Word がいちいち 
開くことになって 
しまい、ひどく迷 
惑なことになりま 
した。このため 
Word の登場後は、 
テキストファイル 
の doc 拡張子は影 
をひそめ 、 readme 
も txt 拡張子を使う 
ようになったので 
す0 


11^*1 
八7:: 
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■配布における注意点 


圧縮ファイルにして配布するときは、リリイサーで生成した実行形式ファイ 
ルの他に readme . txt を書きましょう。 

このファイルは、作品の説明や利用条件、バー I ジョンアップ情報などを記載した 
『わたしを読んでね』という名前のテキスト•オァイルのことで、パソコン通信 
上で MS - DOS 時代のプログラムがやり取りさ#ていたころから存在しています。 
readme ファイルは、以下の三種類の形式で作ることができます。 


純然たるテキスト•ファイル 

html 形式 

Windows のヘルプフアイル形式 


Windows 標準のヘルプ.ファイル形式であ_ 「 hip 」 形式は、作るにはコツ 
が必要ですし、一部利用しにくい点があるため、あまり使わないほうがよいで 
しょう。これが持つメリットの多くは馴染み深い html 形式が兼ね備えている 
ので html で作ったほうがよいかもしれません。 

ただし、 html にするほどの内容でなければテキスト形式をお勧めします。テ 
キスト形式の最大のメリットは、対応するテキスト.エディタやメモ帳が短時 
間で起動でき、すぐに内容を読むことができる点です。このように、 ゲームの 
説明を簡単に行なう程度なら純粋なテキスト形式のほうがべターです。 

readme は「こう書かねばならない」というルールはありません。すでに配 
布されている作品などを参考にしながら、い^ばん見やすいと思えるものを真 
似するとよいでしょう。 

こうして、実行ファイルと readme . txt が準_できたら、圧縮ユーティリティ 


します。 「 Config . tjs 」 内で指定 
ルダについては、「吉里吉里2」 
梱する必要はありません。 

メディア上で実行ファイルを実 


を使って LZH 形式などの圧縮ファイルに圧縮 
した、ゲームのセーブ•データを保存するフォ 
では自動的に作成されるようになったので、同! 

ただし、 CD - ROM などの書き込み不可能な 
行すると、 savedata フォルダが CD - ROM 上に作成できないため、エラーにな 
ります。回避するには、インストーラを用いてハードディスクにインストール 
するか、実行ファイルを手動でハードディ^ク上にコピーしてもらうよう 
readme で説明をする必要があります。 
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ここではある程度 KAG を使ったことがあり、コン 
ピュータに関する知識はあるが TJS がどういうも 
のかを知らないという方を対象に、 KAG をサンプ 
ルにしながら TJS の解説をします。 








KAG と l|jS 




ほとんどの方は「吉里吉里」というと 「 KAG 」 を使っていると思います。 
KAG を使えば、 「 TJS 」 がどういうものであるかを知らなくても、吉里吉里上 
でプログラミングができます。そのため、 「 TJS 」 がいったいどういうもので何 
をやっているかを知る機会は少ないかと思い_す。 


* スクリプト言語 
script language 
アプリケーションの機 
能を補完する簡易言語。 
Perl などもこれに含ま 
れる。 


簡単に言うと、 TJS は、「吉里吉里が直接解できるスクリプト言語*」で 
す。逆に言えば、吉里吉里は TJS 以外の言語^理解できません。 

でも、 「 KAG でもプログラミングできるよ？」「あれ？ KAG で今まで書いていたの 
は吉里吉里用のスクリプトじやないの？」という C とになりますよね。違うんです。 


ここではっきりさせておきましょう。 


「 KAG 」 は 「 KAG 用のシナリオ」を実行ずる。 
「吉里吉里」はその 「 KAG 」 を実行する。 
「 KAG 」 は 「 TJS 」 で書かれている。 


ということなのです。 


趣％^溫トル 


▲論::： 


►通 


KAG は KAG 用 
シナリオ老実行 


亩里亩里は KAG の 
TJS スクリプト奄実行 


吉里吉里は KAG 用のシナリオ • ファイルを f ： 接実行しているわけではないの 
です。 KAG は「吉里吉里を ノベルア ド ベンチャーゲーム.エンジンと して動 
作させるためのスクリプト」という、ちょっとややこしい表現がされているの 
はこのためです。吉里吉里が ノベルア ド ベン#ヤーゲーム • エンジン として動 


作するためのロジックがすべて TJS で書かれて 

いるのです。 

1_ 

■ KAG を 読 令う 

KAG を使っている皆さんは、 KAG の system 
とがあるでしよう。さらに、一度はそのフオル 

フォルダを必ず一度は視いたこ 
ダにある [ Config . tjsJ を編集した 


ことがあると思います。 
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rConfig . tjsJ の拡張子 「 tjs 」 はいったい何表わしているのでしょうか。 










1-1 KAG と TJSQ^ 

_ _ 鑛攀參 _ 泰 

そうです。 「 TJS って何だろう」と思いつつ、必要に駆られていじっていた 
この 「 Config . tjs 」 …それこそがまさに 「 tjs スクリプト」なのです。 

他にも拡張子が rtjsj になっているファイルがいくつもあると思いますが、 

これらが全部 TJS スクリプト • ファイルです。 KAG がどのように動くべきかが 
すべて記述されたファイルたちなのです。 


TJS を学ぶ場合、いったいどこから入門したらよいか迷うと思います。入門 
の「門」はさまざまなところにあると思いますが、ここでは KAG を読み砕く 
ことによって TJS を学んでいくことにします。 

KAG は吉里吉里を使おうと思った方がほとんど経験されているでしょうし、 
KAG は吉里吉里/ TJS の最大のサンプルであります。学ぶにあたり、すぐ手元 
にあるこのスクリプトを活用しない手はないでしょう。 


TJS はど51、5言 


TJS はスクリプト言語です。 KAG もスクリプト言語の一穐ですが、それより 
は相当複雑な文法です「そのぶんできることも待 1当複雑になります， 

TJS を簡単に説明するために、よく 「 Java * と JavaScript •を足して3で割っ 
たもの」と表現しています。「：つのものを足しておきながら3で割っている 
というのはどういうことなんだ？」と思うでしょうが 、 Java §語と JavaScript 
言語の両方の特徴を持っておきながら、それらよりは簡素化されているという 
意味です。どちらかというと JavaScript に似ています。 

特徴としては①「タイプ•ルーズ*」な言語であること、②オブジェクト指 
向的手法をサボートすること、③ CH 語系の文法体系をもつということですコ 
この系統の言語はいくつかあって 「 JavaScript 系」などと n われていますが、 
Web ブラウザで広く用いられている本家 「 JavaScript 」 別名 「 ECMAScript • J 


や、その互換スクリプトである Microsoft の 「 JScript」、Macromedia Flash の 
制御言語である 「 ActionScript 」 もこの系統の言語です。これらの言語を既に 
使ったことのある方ならば比較的簡単に TJS を使いこなせるようになるでしよ 


う。あるいは、 TJS をいきなり学びはじめるのはつらいという方は、これらの 


言語から先に学ぶのも手かと思います。 


* Java 

Sun Microsystems 社が 
開発したオブジェクト 
指向のインタープリタ 
言語」機器依存のないブ 
ログラム開発ができる。 

* Java Script 
Netscape Communications 
によつて開発されたス 
クリブト言語。 Java と 
の互換はない。 

* タイプ • ルーズ 
型による拘束の甘い。 


本 ECMA 

European 

Computer 

Manufacturers 

Association 

欧州霉子計算機工業会 


TJS がどういうものかを知らない方は、 KAG の TJS スクリプト群をぜひ一度 
「流し読み」してください。いまは意味が分からなくても、難しそうに思えて 
も、大丈夫です。ただ、その雰囲気をつかむだけでいいのです。 
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TJS とは 


m 

雜 


DO 

TJS を勉 5 


TJS を学び始める準備 


s を勉強するための準備をしましよう t 



■ 用意するちの 


と言っても、みなさんはすでに手元に吉里吉里と KAG をお持ちでしょう。 
「テキスト.エディタ」は TJS スクリプトを編集したりするのに必要ですが、 
これといって他に必要なものはありません。すべてのツールをフリーソフトで 
用意して、フリー(無料)でプログラミングを始めることだってできます。 




ておくと便利なこと 


吉里吉里には「スクリプト‘エディタ」と「コンソール」というものがあり 


ます。 


* スクリプト•エディタ 
script editor 


* コンソール 

console 


「スクリプト•エディタ •」は、吉里吉虽の実行中に Shift + F 2 を押すとでて 
くる簡素なエディタで、ウィンドウの左下にある青い右向きの矢印をクリック 
すると、入力されたスクリブトを TJS スクリプトとして実行できるものです。 

「コンソール*」 は、吉里吉堕の実行中に Shift + F 4 を押すと出てくるもので 
す。下の入力欄に TJS 式を入力するとすぐに結果を表示できます。また、いろ 
いろなデバッグ用メッセージを表示することのできる埸所でもあります。 

また、吉里吉里の起動時に「フォルダ/ァーガイプの選択」というウィンド 
ウが出ますが、ここで rm 択しない」ボタンを押すと、スクリプトを何も読み 
込まない状態で吉里吉里を起動することができます。素の状態の吉里吉里で 
何かテストをしたい場合に便利です。 


実験用のフォルダを作ろ f 


吉里吉里はプロジヱクト、つまり開発を行なう隼位をフォルダ単位で管理 
しています。起動時に「スクリプト.ファイル」ではなく「フォルダ」を選択 
するのはそのためです。 


なので、空のフォルダを適当な名前で作りましょう。 「 krkr . eXe 」 のあるフ 
オルダ直下に作ると楽です。ここではこれを「実験用のフォルダ」と名付ける 
ことにします。 


— • 192 











第 2 
























m 


※筆者注 

「 TJS 式」といっても 
「折り a み式」や「電動 
式」の意味の「式」で 
はなくて「数式」「方程 
式」に近い意味の、「計 
算の方法や関係を表わ 
したもの」という意味 
の「式」です。 


on 

KAG を使ったこ< 


TJS 式とは 


とのある方なら、 「 TJS 式」というのを何度か聞いたことが 
あるでしよう。 emb タグや eval タグ、 if タグの exp 属性や cond 属性など 、 KAG 
はいくつかの場面で 「 TJS 式」を必要とします※。 


TJS 式は変数を使う際には避けて通れないものなので、変数を一度でも使っ 
たことのある方なら必ず TJS 式を使っていたことになります。すでに TJS の一 
端に触れて I ゝたわけですね。 


KAG の変数操作に用 t ゝるような TJS 式は、 TJS という言語全体から見れば 
ごく一部の機能を使ったにす ぎません。 もっと複雑なこともで きます。 でも、 
初歩から入るのですから、ここでは まず 簡単な式からお話しし ます。 KAG の 
変数操作に慣れた方はすでに知ってる内容かも しれません。 


「1+2は？」と聞かれれば「3」だと誰もが分かるでしよう。この「1 + 2」と 
いうのは私たちがよく使う数学の「式」です。この私たちの分かりやすい式と 
似たような方法で TJS も式を解釈することができます。 


実際に試してみましょう。 

コンソールを開いてみてください。 

吉里吉里を起動し、「フォルダ/アーカイブの選択」というウィンドウで「選択 
しない」をクリック、 Shift + F 4 を押します。 



コンソール画面 
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2-1 


そこに、 

1+2 

と入力して Enter キーを押してください。 


すると、 コンソールに、 

コンソール：1+2 = ( int ) 3 

と表示されたと思います(ここには書きませんが、実際には行頭に現在時刻が 
表示されます)。これは、「あなたが今入力した1+2の結果は3です」という意 
味なのです。 


同じように、 

4/2+2*3 

と入力して Enter キーを押してみてください。 

コンソーノレ： 4/2+2*3 = ( real ) 8 

と表示され、結果が「8」であることが分かります ( int や real については後で 
お言舌しします)。 

「/」（スラッシュ）は私たちが普段「+」と書いている「除算」を表わす記 
号で、「*」（アスタリスク）は私たちが普段「 X 」と書いている「乗算」を表わ 
す記号です。私たちが乗算や除算を足し算より先に計算しなければならないの 
と同じように、 TJS も式を優先順位をつけて計算します。 


カッコや実数*も計算できます(以下に例を示します)。 


コンソール： 

(1+2)*3 

= ( int ) 9 

コンソール： 

4*2.5 = 

( real ) 10 


コンソールを 使うと、ちょっとした電卓としても使えますね。 


また、 KAG を使う方は、変数*に値を代入したいときに「=」を使って、 
f . flagl =0 

などとコンソールに入力すれば、その時点ですぐに変数に値を入れることがで 
きます。 

ここで使っている「=」（イコール)は私たちが普段使っている「=の右側と左 
側が等しいことを示す」という意味ではありません。「=の左側に、右側の値 
を代入する」という意味になります。このように、私たちが普段使っているの 
とはちょっと違う意味で記号が解釈されるものもあります。 


tjs 式とは na 

春 _ _ _ 參# 馨 


* 実数 

誤差を含む数。小数点の 
ついた数。 


* 変数 

さまざまな値を一時的 
に入れておく メモリ領 
域。 
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今はコンソールに直接式を入力して実行し、結果を確認しました。このよ 
うに式を実行することを、「評価する」ともいいます。 


* 関数 

まとまった機能を呼び 
出して使うもの。 


式の役割 


TJS の式の役割を考えてみましょう。 TJS において「式」は非常に重要なも 
のです。ほとんどすべての動作は「式」によって記述されていると言っても過 
言ではありません。 

KAG の 「 Utils . tjs 」 にある 「 han 2 zen 」 という関数*(関数については後で説 
明します)にはどれぐらいの式が使われているかを示しましょう。 


kag 3¥ template ¥ system ¥ Utils.tjs 

function han2zen (str) 

{ 

var res; 

var i ； 

for ( i=0 ； i<str.length ； i++) 

{ 

var num=#str fi1 ； 
if fnum>=0x002Q &&： num< = 0x7e) 

res+=$(OxffQQ+num-0x2Q )； 
else res + = str \ i 1 ； 

} 

return res ； 


上記の下線のあるところがすベて式です。かなりの部分が「式」ですね。い 
かに式がスクリプトの大きな部分を占めているかが分かると思います。 


これは「式」に与えられた力が、単に数値を足したり引いたりするような、 
私たちが普段「演算」として考えているようなことだけではなく、もっと重婆 
な動作や意味をもつことができるからです。これも追々説明していくことにし 
ましよう。 
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このような TJS の式がどのように構成されて、どのように使われるかを見て 
みましょう。 


項と演算子 


TJS におけるすべての式は、「項」または「項と演算子」で出来ています。 
これには例外はありません。 

今までに出てきた「+」卜」「*」「/」「=」「（）」「」のような記号は、すべて 
「演算子*」と言います。演算子には、計算の方法を指定したり、操作を指定 
したりする機能があります。 

TJS には以下のようなたくさんの演算子があります。 

>>=>> >=> >=> <<=<= <-> << < ========> =! == ! = ! 

&&= && &= Sc | | =丨丨 |= | ••• • ++ += + - = — - * = 

* /= / \= \ %= % -=-[](>〜■?:,#$ 
delete incontextof invalidate mstanceof lsvalid 

—int if new octet real strinq typeof_ 

それぞれ重要な意味をもっていますが、よく使うのはほんの一部です。 

簡単な演算子には以下のようなものがあります。先ほども使いましたね。 


* 演算子 

式の中で変数などに何 
らかの処理を行なう。 


演算子の例 


演算子 

意味 

+ 

足し算 

- 

引き算 

★ 

かけ算 

/ 

わり算 

1 

■" 1 

代入（左側の変数に右側の値を入れる） 

0 

カツコ(演算の優先順位を決める 


これらの中には場合によっては別の意味をもつものもありますが、追々説明しま农 
また、もちろん他の演算子もたくさんあります^これらも追々説明しますし、 [付録】 の 
彍算子一覧」や、 「 TJS 2 リファレンス」などを適宜参照していただけると幸 t ゝです。 


演算子の両脇にあった「1」や「2」などの数字、あるいは 「 f 」 や 「 flagl 」 
などの演算子でない文字は、「項」と呼ばれます。計算や操作方法を指定する 
「演算子」に対して、計算や操作される対象の「値」を表わすものです。 
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參⑩ _ 馨拳攀 


* ステートメント 
statement 


式 

讀 戀鑛雜”パ、:：.-:.、，：.:ベ 

修 

_ 

「頃」のみの「式」も tjs においては有効な「式」です。この場合は r 演 
算子」がありませんから、演算などはされずに、その項の値そのものを表わす 


ことになります(難しく考えることはありません。単に「3」という項を書いた 
ら「3」という意味だということです)。 



式は以下の形式でよく使われます。 
式； 


式のあとに セミコロンを 書きます。これは「文」と呼ばれるもののうちの一 
つです。私たちが日本語で文章を書くときに文末に「。」を書きますよね。そ 
れと同じように、 TJS では文の終わりには 「;」（セミコロン） を書きます。 

文はたくさん書かれた場合は、スクリプトの上から順に、書かれた順に実行 
されます。文は「ステートメント*」とも呼ばれます。 


式と結果 


式にセミコロンをつけたものが 一つの 文であるというお話をしました。「式 
にセミコロンつけて書いて、いったいどうするの？」と思うかもしれません。 
たしかに「1+1;」と書いたところで「1 + 1」が計算されますが、計算された結 
果はどこにいくんだろう、ということになります。 

結論から言うと、計算された結果は捨てられます。つまり、「1+1;」と書いて結 
果が「2」になろうと、その結果は捨てられる、つまりなんの効力ももたないのです。 

「結果が捨てられるんじゃ意味がないじゃないか」ということですが、必ず 
しもそうではありません。たとえば卜」演算子、これは単純な演算ではなぐ 
「代入する」という立派な動作を伴います 。 「a = l ;」 と書くと、 「 a に1という 
値を入れる」という動作をした後、その式自体の結果が捨てられるのです。結 
局、この式を実行した後は、 「 a 」 には「1」が入っています。 

ただ、先ほど例に出した「1+1;」は本当に意味がありません。「1+1」は演算 
をして結果が出てくるだけでほかにはなんの動作も伴わず、さらにその結果が 
捨てられるのですから意味のない文なのです。実際は、 TJS はこういう文が書 
かれたとしても、まったく意味をなさないものとして実行すらしません。 

「二」演算子が変数に値を入れるように、演算の過程で伴う動作のことを、 
「副作用」と呼んでいます。 TJS における、式の後にセミコロンが付いた文は、 
副作用を起こすように記述するのです。 
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ここでは、昔からよく用いられる 「Hello world !"」 
を画面に表示するプログラムを書く J ことで 、 TJS 
でのブ□ダラミングの一5龍に触れたいと思います。 
いにしえの音から、プログラミング言語を学ぶとき 
には、画面に “Hello world !” と表示するプ□グ 
今厶を組むことになっているようです。私たちもこ 
の通過儀礼に則ってみましょう。 
























コンソールに、 以下のように入力してみましょう。 
"Hello world !" 


すると、以下のように表示されるはずです。_ 

コンソーノレ ： —"Hello world ! " = ( string ) "Hello world !" 


* 文字列リテラル 
シングル/ダブル • クオ 
ーテシヨンで囲まれた 
文字の並び。 


プログラミングをしたという気にはおよそなれないかもしれませんが 、 TJS 
が理解できる形で TJS に指示を与え、その結果 Hello world ! を表示できたとい 
う点においては立派な Hello world ! と言えます。また、コンソールの下の入力 
欄は正しい TJS 式のみを受け付けますので 、 "Hello world ! 1 ' が TJS 式として正 
しいことが分かります(文字列リテラル*という項のみの式です)。 

それにしてもこれでは物足りないので、別の方法を試してみましょう。吉里 
吉里は画面に文字を表示する方法をいくつももっていますが、簡単な 「 Sys - 
tem . inform 」 というものを使ってみます。 


「スクリプト•エディタ」を表示させてください。 

吉里吉里を起動し、「フォルダ/アーカイブの選故」というウインドウで「選 
択しない」をクリック、 Shift + F 2 を押す。_ 

そこに以下のように入力してください。 

System . inform("Hello world !”）； 


入力できたら、ウィンドウの左下の右向きの青い矢印をクリックしてくださ 
い（あるいは Ctrl + Enter でもい t 、です)。 

画面に 「 Helloworld !」 と書かれているウィンドウが表示されましたか？ 
「スクリプトで例外が発生しました」というメッセージが表示されてしまっ 
た人は、どこか入力したスクリプトに間違いがあったということです。よく見 
直してみてください。 
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正しければこのように表示される 


首尾良く表示されたら、 "Hello world!" の文をいろいろ変えてもその通りに 
表示されることを確かめてみてください。 


— System.intorm ( 丄 +2 リ _| 

のように数式を入れると、その結果が表示されるのが分かると思います。この 
ように、 「System.inform」 は、その次に （） で囲まれた式を書くと、その内容 
を画面に表示することができるものだと言うことが分かると思います。 



計箄結果が表示される 


前の節で「式にセミコロンをつけたものは一つの文である」とお話ししまし 
た。 「System.inform(l+2);」 も文です。そして、 「System.inform」 は内容を画 
面に表示するという立派な副作用をもつ式です。 

そういえば、 「System.inform(l+2)」 が式ならば、「1+2」も式ですね。この 
ように他の式の中に書かれる式を、「部分式」と呼びます。 

「System.inform」 は、「（）」の中に書いた部分式の結果を表示するものと 
言うことができます。このように、式は文法が間違っていなければいくらでも 
複雑に書くことができます。 
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* プロジェクト 
ブログラムに必要な情 
報を集めたファイル。 


前に、 r 吉里吉里はプロジヱクト*をフォルダ単位で管理すると」述べまし 
た。吉里吉里は起動時にプロジヱクト • フォルダを指定されると、そのフォル 
ダの中にある 「 startup . tjs 」 というファイルを実行しようとします。そこで、 
この startup . tjs に” Hello world !" を表示するプログラムを書いてみましよう。 


実験用のプロジヱクト • フォルダの中に 「 startup . tjs 」 というファイルを作 
ってください。それをテキスト•エディタで開いて、以下のように入力して保 
存します。 

Svstem.inform("Hello world! n ); 


はい、先ほどと同じです。 

そうしたら、吉里吉里を起動し、「フォルダ/アーカイブの選択」で、その 
実験用のプロジェクト • フォルダを指定しましよう。 

スクリプト•エディタから実行したのと同じように、 " Helloworld !" と表示 
されたと思います。 



startup . tjs が作られていないと、エラー • メッセージが出る。 
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KAG でも「変数」という言葉は出てきました。ただ実は、「変数」だと KAG 
で説明してきた 「 f .」 や 「 sf .」 が頭につくものは、 TJS で言うところの「変数」 
とはちょっと違ったものなのです。これは「辞書配列」のところで再び説明し 
ます。 


TJS における「変数」とは、プログラマーとなるあなたが自由に名前を付け 
て、自由に値(数値や文字列などいろいろなもの)を入れておける場所です。変 
数を宣言するには、 fvarj を使います。 


さっそく使ってみましょう。前の章で説明した " Hello world !" のプログラムを 
少し変えてみましょう。わざわざ 「 startup . tjs 」 に書き込んで実行するのは面 
倒なので、スクリプト•エディタで実験してみましよう。 


( startup . tjs に書いても、同様の結果が得られると思います)。 


* 編注 

実際のスクリプトには 
行番号は必要ありま发ン」 
ん〇 






var message; 

message = "Hello world! 
System, inform (message); 


実行してみると、単に 「System.inform("Hello world!");」 というプログラム 
を実行したのと同じ結果になると思います。 



同じように 「Hello world !」 が表示される 


* 宣言 

どのような変数を使う 
かあらかじめ決定する 
こと。 


1行目で 「 message 」 という名前の変数を宣言*しています。 「 var 」 の使い 
方は次に述べます。 

2行目でその 「 message 」 という名前の変数に "Hello world !" という値を入 
れています。「値」と聞くと「あれ？これは文字であって『値』ではないよ」 
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4-1 変数とは13113 

####### 

と思うかもしれませんが、ここでは変数に入るものすべてを総称して「値」と 
呼んでいます。 

代入をするための演算子「=」は、 KAG で変数を使うときにも使いました。 

私たちが普段用いる「=」の意味とは違うので、注意が必要です。 

3行目では「 System . inform 」 を使って「 messsage 」 の中身を表示していま 
す。 「 message 」 の表わすものの内容が画面に表示されているはずです。 

また、プログラムが上から順に、書いた順に実行されているのが分かると思 
います。 
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var の使い方 

var キーワードは変数を「宣言」するために用います。 TJS では変数を使お 
うと思ったら、その変数を使うことを「宣言」しなくてはなりません。 


変数を宣言するには、 「 var 」 に続いて「スペース」を空け、変数名を書き、 
「;」（セミコロン）を書きます。 

上記の例では 「 varmessage ;」 と書くことで 「 message 」 という変数を宣言 
したことになります。 


変数はカンマで区切っていくつでも宣言することができます。たとえば、 

__ var a, _b , _ c ； _ 

と書けば、 「 a 」 と 「 b 」 と 「 c 」 の3つの変数を宣言したことになります。 


もちろん、これは、 

var a ； 
varb ； 
var c ； 

とも書けます。 

変数名の後に「=」（イコール）を書いて、その後に「式」を書くと、その変 
数にあらかじめ、その「式」の表わした値(数値や文字列など、なんでも）を入 
れておくことができます。 

たとえば、上記の "Hello world !" のプログラムは、 
var message = "Hello world!" ； 

System, mform(message); 


と書くことができます。 











KAG の変数と同じく、 TJS の変数にも、「使える名前」と「使えない名前」 
があります。これは頭に 「 f .」 や 「 sf .」 が付かないこと以外は KAG の変数のお 
約束とまったく同じなのですが、ここでおさらいすることにします。 


変数名には半角英数と全角文字 、 rj (アンダー•バー）を使 
ラことができる 


「 abc & def 」 や 「 a - z 」 のような変数名は使えません。 


「 fina し count 」 のようにアンダー.バーを含んだり、主人公の名前のよう 
に全角文字を使うことができます(全角の記号はすべて使用可能です)。 


変数の名頭に半角の数字がくることはできない 


「2 friends 」 や 「3 size 」 のような変数名は使えません(全角の数字が先頭に 
くるのであれば 0 K です)。 


「予約語」は使えない 


以下の単語は「予約語」なので使えません。 

break continue const catch class case 
debugger default delete do extends export 
enum else function finally false for 
global getter goto incontextof invalidate 
instanceof isvalid import int in if 
null new octet protected property private 
public return real synchronized switch 
static setter string super typeof throw 
this rue try void var while with 


ただし、 「 count _ to _ skip 」 や 「 count _ true _ ends 」 のように、予約語*を「含 
む」ことはできます(予約語そのものの変数名は使えないというわけです)。 
上記の例では 「 message 」 という名前の変数を使っています。特に理由が 


* 予約語 

変数として自由に使え 
ない単語。 
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変数 




ない限りは、分かりやすい名前を付けるべきです。筆者は、慣用的に以下の 
ような変数を使います。これらの変数名を使わなければならない理由はまった 
くないのですが、実際、 KAG の TJS スクリプトではこのような変数が多用され 
ているのでここで簡単に述べておきます。 


慣用的な変数の使い方 


■数名 

______ ::隱 ^ 

味 


ijk 

よく for 文のカウンタ用の変数として使う。 

n 

よく整数を表わす。 

str 

よく文字列を表わす。 
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TJS におけるデータはすべて「型」をもっています。データの特性を決める 
重要な概念です。 



KAG の変数は数値でも文字列でも入れることができました。 TJS の変数も 
そうです。この「数値」や「文字列」というのが「データ型」、つまりそのデ 
ータがどういう種類のものであるかということです。 


KAG で変数を操作する場合には、 TJS のもっているすべてのデータ型を使う 
ことはおそらくないでしょう。ただ、 TJS のデータ型は、「数値」や「文字列」 
だけではありません。これから TJS の扱うことのできるデータ型について説明 
します。 


本当は、ここで紹介する他に「オクテット列型」というのもありますが、こ 
こでは説明しません。 


整数型 


そのままズバリ、整数*を扱うことができる型です。 

扱える数には上限と下限があって、「上限」は約922京、「下限」は約マイ 
ナス922京です。日常的に使うほとんどの数値はこの範囲内に収まっているの 
で、とくに困ることはないと思います。 

コンソールでは、結果がこの型になったとき （ int *) という表記をします。 

TJS スクリプト中にこの整数型の数値を書くときは、普通に数字を書けば 
「10進*整数」として扱われます。このように、スクリプト中に直接現われる 
数値や文字列そのものの項を、「即値」と呼んでいます。 

試しにコンソールの下の入力欄に「123」と入力して Enter キーを押してみ 
ましょう。 「( int )123」 と表示されたと思います。これは入力された数値が、 
「123」という「即値」で、「整数」として扱われていることを示します。 


デ-夕型 

攀攀響看 _ _ 


* 整数 

0 と自然数、逆自然数。小 
数点の無い数。 


* int 

integer 

整数 

*10 進 

「0」から「9」の数値を使 
つて、「0」から顒にカウ 
ントし、「9」の次に、桁 
上げをして「10」と表現 
する。 
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警響響響響 


*16 進 

16で桁上げをして「10」 
と表現する方法。_桁 
分で〇〜15までの数値 
を表すため、「〇」から 
「9」まではそのままだが 
10以降は「八」から「「」 
の文字を用いる。 

* 実数 

誤差を含む数。小数点の 
ついた数。 


即値を書くときに先頭に 「0 x 」 を付けると「16進*表記」の整数になりま 
す。たとえば 「 Oxff 」 と入力して Enter キーを押せば、 「( int )255」 と表示され 
るでしょう。これは 「 Oxff 」 が「255」という整数として扱われていることを示 
しています。 


実数型 


実数*を扱うことができる型です。小数点以下の値も扱えます。 

この実数型にも扱える数に上限と下限があって、「上限」は約 1.79 X 10 3 。 8 、 
「下限」は約-1.79 X 10 3 。 8 です。精度は10進で約15桁あります。 


コンソールでは、 結果がこの型になったとき 「( real )」 という表記をします。 


文字列型 


文字列を扱うことができる型です。 


文字列の長さに制限はありません。 


TJS スクリプト中に文字列を直接書くときは「""」（ダブル•クオーテーシヨ 
ン）または卩リ（シングル•クオーテーシヨン）で囲まなければなりません。この 
ように、「""」や M で囲まれた、 TJS スクリプト中に直接書かれた文字列の 
即値を「文字列リテラル」と呼びます。この文字列リテラルは、さっそく 「Hello 
world !」 にもありましたね。 KAG のソースにもところどころ出てきています。 


演算子である「+」（プラス）演算子は数値を加算する演算子なのですが、こ 
れが文字列を相手にして使われると、「2つの文字列を連結する」という意味 
になります。数値としての加算が行なわれるのは、+の両側が両方とも数値型 
(整数型か実数型)の場合だけです。どちらかが文字列、どちらかが数値だった 
場合は、数値は文字列に変換されてから連結されます。 

たとえば 、 Hello world ! を以下のように改造してみましょう。 
var message 1= "Hello ", message2 = "world !”； 

System.inform(messagel + message2 )； 

改造しないままのものと結果が同じになったと思います。 「 messagel 」 に入 
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っている " Hello ” という文字列と、 「 message 2」 に入っている 1 ， world !” の文字 
列を、「 messagel + message 2 j という式で連結して " Helloworld !” という文字 
列にし、それを表示しています。 

コンソールでは、結果がこの型になったときには (string) と表記します。 


データ型 



攀攀翁_ # _黎 


:クト型 


オブジヱクト型は「オブジヱクト*」を扱う型です。 


* オブジェクト 
object 


オブジェクトには「関数」「クラス」「辞書配列」「配列」「プロパティ•才 
ブジェクト」などなど、いくつか種類があります。オブジェクトについては、 
またあとで詳しく説明します。 


コンソールでは、 結果がこの型になったとき 「( object )」 と表記します。 


void 


void * 型は「何も表わさない」ことを表わしています。 


void 型には何も入りません。 void 型は void 型であり、そして「何も表わさ 
ない」のです。 


ホ void 
ヴオイド 

空虚 


しかし、何も表わさないといっても、何も表わさないなりに、数値としては 
「0」、文字列としては「空」文字列として扱われます。 

「 void 」 というキーワードがあって、これが常に void になります。コンソー 
ルから 「 void 」 と入力してみましよう。「コンソール ： void = ( void )」 と表示さ 
れたと思います。コンソールでは、結果がこの型になった場合、 「( void )」 と 
表記します。 

宣言したまま、何も値を入れていない変数は void 型になります。また、後 
で説明しますが、何も値を返さない関数は 「 void 」 という値を返していると見 
なされます。 
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翁鬱纛 _ 鬱 _ 

* タイプ. ルーズ 
type loose 




タイプ•ルーズ 


TJS は「タイプ•ルーズ*な言語」（データ型による拘束がアマく、ダラシな 
い言語）という類のものです。 

他のプログラミング言語と比較すると分かると思いますが、 C ++ や Java 、 
Pascal のような言語は、データ型に厳しい言語です。変数を宣言するときにそ 
の変数の「型」も一緒に宣言しなければならなく、その変数にはその宣言した 
型のデータしか入れることができません。これに対し、 TJS の場合は型を指定 
しません。その変数に入れたデータ型によって、その変数の型が決まります。 


C ++ や j ava や p asca l では、たとえば文字列を整数に変換するのは、通常、そ 
の言語仕様としてはサポートされていません。 

TJS の場合は、たとえは聲数が要求される場面で文字列を渡しても、自動的 
に文字列を整数に変換して処理します。文字列が要求される場面で実数を渡 
せば、実数が文字列に変換されて使われます。つまり、型変換を、ある程度 
自動的に行ないます。 

このように型に関してあまり厳しくないので「タイプ•ルーズ」と呼ばれて 
いるのです。型をあまり気にせずに気楽に使えるというメリットがあります 
が、型に起因するバグを見付けにくいというデメリットがあります。 
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* サブルーチン 
sub routine 

機能的にまとまった処 
理を行なうルーチン。 


「関数」というのは「何か機能をまとめて書 t ゝておいて、あとで呼び出して使 
うもの」です。 KAG にもサブルーチン*がありましたが、それと概念的には同じ 
です。もちろん TJS の「関数」は数学で使う意味のように「与えられた値に対す 
る数を示すもの」という意味でも使えますが、たいていは前述の用途でしょう。 




関数をみてみる 


なにはともあれ、 KAG で定義されている関数を1つ見てみましょう 
「Utils.tjs」 にある 「intrandom」 という関数です。 


,runctlon intrandom(min = 0, max 


〇) 


// min 以上 max 以下の整数の乱数を返す 

// 引数が一個だけの場合は〇〜その数までの整数を返す 

if(min>max) { min <>-> max ； } 

return int (Math. random () * (max-min+1)) + min ； 


先ほど「定義」と言いましたが、関数も変数と同じく、定義(宣言）しなけ 
れば使えません。定義にはこのように 「function」 を使います。 

「function」 に続く 「intrandom」 というのが「関数名」で、この名前の付 
け方には規則がありますが、変数のものとまったく同じです。 


* 引数 

プログラム • コー ドが 
関数やサブルーチンを 
呼び出すときに渡す値。 


関数名の次には （） で囲まれた部分があり、この中に「引数*」を書きます。 
引数とは関数に渡される値のことです。関数に渡した値は、ここに書いた変数 
に入った状態で受け取ることができます。「=0」と書いてあるのは、「関数を呼 
び出すときに、その引数が省略された場合は0になりますよ」という意味です。 


* 乱数 

でたらめな数値。 


そのあとの「{」と「}」で囲まれた部分が、関数の中身です。 

この関数の中身については今はまだ説明していないものが多いので詳しくは 
述べませんが、そこに書かれたとおり、「与えられた2つの引数のうち、 min 
以上 max 以下の乱数を返す」という機能をもつ関数です。 

ただ、その中に 「return」 というのがあるのに注目してください。 return は 
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5-1 関数とは 


飜#響# 




そのあとに書かれた式を関数の「結果」として返すためのものです。この値は 
「返値」や「戻り値」など、いくつか呼び方があります。関数が何か値を返さ 
なければならない場合、必ずこの return を使います。 


関数を呼んでみる 


実際に関数を使ってみましょう。関数を使うことを「関数を呼ぶ」とも言います。 

KAG を起動してみてください。吉里吉里 SDK についてくる紹介用スクリブ 
卜でもけっこうです。そして Shift+F4 でコンソールを表示してください。 

コンソールの下の入力欄に 「intrandom(l, 3)」と入力して Enter キーを押し 
てみましょう。1以上3以下の乱数が表示されるはずです。 


このように、関数を呼び出すときは関数名の後に （） を書き、その中に引数 
となる式をカンマで区切って書きます。もし、その関数には引数の必要がない 
なら、 （） の中には何も書きません。 


関数名の後に （） を書くのは” Hello world!” でもすでにやりました。あれは 「Sys- 
tem.inform」 という関数を呼んでいたのです。引数は画面に表示するものでした。 


また、上に示した関数 rintrandomJ の中にも関数を呼んでいるところがあ 
ります。どこにあるか分かるでしようか。 


はい、 「Math.randomO」 ここです。 「Math.random」 という関数を呼んでい 
るのです。この関数は0以上1未満の実数の乱数を返すという関数で、弓I数 
は無いので （） の中には何も書かずに呼んでいます。 

「あれ、“ if” や “int” というのもあるけど、これは関数を呼び出しているのでは 
ないの？」ということなのですが、 if は if 文という重要な文であって、関数呼び出し 
ではありません。 「int*」 は演算子で、「右側に書かれたものを整数に変換する」と 
いう演算子です。右側の式が （） で囲まれているので関数の呼び出しに見えます 
が、この場合は （） は演算の優先順位を変えるためのものであって、関数の呼び 
出しではありません。 


integer 

整数 


^9 

參肇働 
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関数の使い道 


KAG 鞭っている方なら、サブルーチンの利点は分かるはずです。何度も何度も 
同じような操作を行なう場合は、その一連の操作をサブ;レーチンにしてしまえば、 
あとはそれを呼び出すだけです。同じことが、 TJS の関数にも言うことができます。 

たとえば、以下のような TJS スクリプトがあったとします。 

011 1—1—2 = (ill*ial*(br- 1> * (ia2*br-l)+il2*ia2*br) / 
(ia2*br+ial*(br-1)*(ia2*br-l ))； 

out_3_4 = (il3*ia3*(br-1)*(ia4*br-l)+il4*ia4*br) / 

(ia4*br+ia3*(br-1)*(ia4*br-l)); 


なんだかク'チャクチャしてて二度と書きたくないような式ですよね。もしこの計算 
を何回も繰り返すとき、その都度この式を書くと、プログラムが読みづらくなりま 
す。あとあと自分自身や他の人がプログラムを見たときに訳が分からなくなってし 
まわないように、プログラムはなるべく簡潔に綺麗に書くのがコツとされています。 


上の二つの式はよく見ると共通の構造をしていることが分かります。これを 
関数にして、上のプログラムを書き直してみると、下のようになります。 
function blend (il—a, ia—a, il_b, ia_b, br) { 

return (il_a*ia_a* (br-1)* ( ia—b*br-l)+il_b*ia_b*br) / 

(ia_b*br+ia—a* (br-1)* 
(ia_b*br-l)); 


out_l—2 = blend(i 丄 1,ial,il2, ia2, br); 
out_3_4 = blend(il3, ia3, il4, ia4, br); 

計算を関数にまとめてしまったので、下の2行がすっきりとしていますね。 

このように「同じような操作を関数でまとめてしまう」ことによって、スク 
リブトをすっきりとさせることができます。また、関数に分かりやすい名前を 
付ければ、何をやっているのか一目で分かり、便利です。 

上で述べたように関数を自分で作って使う用途以外にも、どうしても関数 
を使わなければならない場面があります。それは、吉里吉里本体が提供してい 
る関数を使う場合です。” Hello world!” で使った 「System.inform」 もそうです。 
これはもともと関数の形でしか提供されていな t ゝのですから、関数として使わ 
ざるを得ません。 
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関数の作り方 



_拳_癰_ _ _ 



たとえば、引数を2つもち、その2つを加算した値を返すという簡単な関数 
を考えてみましょう。関数の名前は 「add*」 という名前にします。 

関数を宣言するには 「function」 でしたね。スクリプト•エディタに、以下 
のようなプログラムを入力してみましょう。 


* add 
加える 


function add (a, b) { return a + b; } 


function のあとにきているのは関数名、そして （） の中に引数です。 「a + b」 
を 「return」 で返しています。 

上記のスクリプトは一行で書かれていますが TJS ではこのように改行を書か 
ずにスクリブトを一行で書くことができます。これは次の章で詳しく説明しま 
すが、今は「こういう風にもかける」と考えてください。 


入力したら、左下の右向きの青い矢印をクリックです。クリックしても何も 
起こらないように見えるかもしれませんが、実際はこの関数は登録されたので 
す。確かめてみましょう。 


コンソールを表示させて、 「add(l，2)」 と入力してみます。「3」と結果が出 
たでしょう。もちろん、 「add(10,50)」 ならば「60」、 「add(10，-10)」 ならば「0」に 
なります。関数 add の中では+演算子を使っているのですから、 「add("hoge n , 
"moge n )_| * ならば 1 ， hogemoge” となるはずです。 


* hoge 

変数などの例としてプ 
ログラミングによく使 
われる。語源は諸説ある 
が、はっきりとしていな 
い。 
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「 return 文」は、 「 return 」 の次に式を書くことにより、その式の値を関数 


の結果と して 返すことができる文です。文ですので、最後に「;」 （セミコロン) 
を付けなければなりません。 


return の後の式は省略できます。省略された場合 、 「return void ;」 つまり 
「 void 」 を指定したのと同じ意味になり、 void が返されます。また、 return 文 
自体も省略できますが、その場合は関数の終わり、つまり終わりの「 I 」の部 
分で呼び出し元に戻ることになります。この場合も void が返されると見なさ 
れます。 


return はその文が実行された時点で関数の呼び出し元に戻ります。関数の 
途中で、なにか条件によって呼び出し元に戻りたいときにも使えます。 


KAG の TJS スクリプト中の return 文を探してみて、その雰囲気をつかんで 
ください。 
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TJS がブログラムをどのように角?釈するのか、ま 
た、人間にとって読みやすいプ□グラムを書くコツ 
を説明します。 




















文法とスタイル 



TJS は、「プログラム中の空白」「改行」「タブ」など、文字でないような要 
素をすべて同じ「ホワイト.スペース*」というものとして見なします。連続 


* ホワイト.スペース 

white space 


したホワイト • スペースは 一つの ホワイト.スペースとして認識され ます。 

また、意味が分からなくならなければ、ホワイト.スペースを入れなくても 
かまいません。逆に、意味が分からなくならないように適切にホワイト.スぺ 
ースを入れなければなりません。 


「ホワイト.スペース」とは、紙に印刷したときにその文字が印刷されず 
に、ホワイト（白い)スペース（空間)、つまり「空白」になる、そのような「文 
字でない要素」の総称です。ただし、全角スペースは TJS にはホワイト • スぺ 
ースとして認識されないので、注意してください。 


前の章で出てきた以下の関数、 

—functionadd(a, b) _{ returna + b; } 

を例に見てみましょう。 

「空白、改行、タブなどが『ホワイト，スペース』として認識される」とい 
うことは、つまり、たとえば空白を改行に置き換えてもよいわけです。上記の 
プログラムは以下のようにも書けます。 

function 

add(a , 
b) 

{ 

return a + 

b; } 


「連続したホワイト. スペースは一つの ホワイト •スペース として認識される」と 
いうことは、改行の次に空白がきても、それは 一つの ホワイト •スペース であ 
るかのように扱われます。改行の個数や空白の数は問題ではありません。たと 
えば、上記のスクリブトを以下のようにも書くことができるということです。 
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function add (a, b) 

{ 


returns + b ； 

} 




「意味が分からなくならなければ、ホワイト-スペースを入れなくてもかま 
わない」ということに従えば、上記のスクリプトは以下のように書けます。 

function add ( a , b ) {return a+b；} 


「意味が分からなくならないように、適切にホワイト • スペースを入れる」 
ということは、たとえば、もし上記のスクリプトのホワイト•スペースを全部 
取り去って、 

—functionadd(a,b) {returna+b ； } __ 

と書いてはいけないということです。 「 functionadd 」 というのがありますが、 
これでは 「 function 」 と 「 add 」 ではなくて 「 functionadd 」 というつながった 
単語として TJS が認識してしまい、意味が分からなくなるのです。ですので、 
このような書き方はできません。 

このように、 TJS はホワイト • スペースを自由に入れたり、あるいは入れな 
かったりすることができます。このような言語のことを「フリースタイル*」 
の言語と呼んでいます。 

だからといって、やたら改行や空白を入れたり、空白を入れずに詰めて書い 
たりするのは良くありません。読みやすいように書くことが重要です。 


ブロックのスタイル 


TJS のスクリプトをみると、よく { } で囲まれた部分を見掛けると思います。 {} で囲 
まれた部分は「ブロック」と呼ばれ、複数の文をまとめるために使われています。 

ブロックは文法上重要な意味を持ちますし、 {} は対応が見やすいようにし 
ておかなければ読みづらいプログラムになってしまいます。そのため、 { } 内は 
インデントを行なうのが一般的になっています。もちろんインデント*しなくて 
もプログラムとしては動きますが、わざわざ見づらく書く必要はないはずです。 


スタイル 

翁馨鏺鬱馨_ # 


氺フリースタイル 

free style 


本インデント 
indent 
字下げ 
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文法とスタイル 


曝 


KAG の TJS スクリプトをみてもインデントされているのが分かると思います。 
たとえば、 「 Utils . tjs 」 にある rnumber_formatJ という関数の中に以下のよう 

な部分があります。_ _ 

for(var i = 0; i <> n—len; i++) 

{ 

var digit = n[i ]； 

if (digit >= ' 0 1 ScSc digit <>= ' 9 1 ) 

{ 

n—digits 
out += digit; 

if (n_digits > 0 && n—digits % 3 == 0) 
out +=，_,” ； 

} 

else 

{ 

out += digit; 


{ } の中がインデントされているのが分かりますね。 

{ } の書き方には大まかに2通りあって、上記のような書き方のほか、 
for(var i = 0; i <> n 一 len; i++) { 
var digit = n[i ]； 

if (digit >= ' 0 ' && digit <>= ' 9 1 ) { 
n 一 digits --； 
out += digit; 

if(n_digits > 0 && 11 一 digits % 3 == 0) 
out += " パ 1 ; 

} else { 

out += digit; 


のような書き方もあります。 

筆者は前者を使っていますが、どちらでも意味は同じです。見やすい、ある 
いは書きやすいと思ったほうを使うといいでしよう。どちらにしろ、 { } 内は 
インデントされているというのが分かると思います。 
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プログラム 中に、 思いつい たこと や メモを書 t ゝて おきたいことがありますが、 
私たちが普段使うような日本語をいきなり スクリプト* の中に書くと文法 エラー 
になります。当然と言えば当然ですが、 TJS は日本語を理解できないのです。 


そこで、「コメント」というものを使います。コメント*にすると、 TJS はそ 
の部分をまるっきり無視するようになります。プログラムの一部分だけを実行 
したくないときにそこをコメントにしてしまう、という用途にも使えます。 


TJS のコメントの書き方は2種類あって、「/*」と「 V 」の間に書く方法と、 
行の「//」以降に書く方法です。 

たとえば、「関数」の章でも紹介した以下の関数には//形式のコメントが 

使われています 0 _ 

function intrandom (min = 0, max = 0) 

{ 

// min 以上 max 以下の整数の乱数を返す 

//引数が一個だけの場合は〇〜その数までの整数を返す 

it (mm>max) { min <>-> max ； } 

return int (Math. random () * (max-min+1)) + min ； 


// で始まっている行が 2 つありますよね。この行の、//から改行までの部 
分は TJS は無視します。プログラムの動作の解説を書いておくと後で見たとき 
の助けになります。 

もし、これを/* ★/ 形式のコメントにすると、以下のようになります。 
function intrandom (min = 0, max = 0) 

{ 

/* min 以上 max 以下の整数の乱数を返す 

引数が一個だけの場合は〇〜その数までの整数を返す*/ 
if (mm>max) { min <>-> max ； } 
return int (Math. random () * (max-min+1))+ min ； 


コメント ua 

_ # 鬱 _ # # 嫌 


* スクリプト 
script 


氺コメント 

comment 
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文法とスタイル 


m 

鬱 


888liS!llllilliSllillllii®ilSilSiSllBSfiSlIlllSllllllliS 

「//」のコメントと違って「/★*/」は複数行を一気にコメントにできるの 
で、便利です。逆に、「//」は「/**/」と違ってタイピング量が少ないので、 
ちょっとしたコメントに便利〗です。 






if 文は r もし〇〇ならば XX する」という、非常に 
よく使う重要な文です。 






KAG にも 「if タグ」というのがありましたが、 TJS にも 「if 文」というのが 
あります。条件によって実行するもの、あるいは実行しないものを記述すると 
きに使います。プログラム中では非常によく使うものです。これがないと単に 
並べられた文を実行することしかできませんが、 if 文があることで「もし〇〇 
ならばXXする」といった臨機応変なプログラムを書くことができるのです。 
KAG の TJS スクリプトを眺めてみても、 if を非常によく見掛けると思います。 

例として、「閨数」のところで紹介した関数を再掲しましょう c 
function lntrandom (min = 0, max - 0) 

{ 

if (min>max) { min <-> max ； } 

return int (Math.random() ★ (max-mirn-l))+ min ； 


if 文は上記の rif(min>max) {min<^>max;}J の部分です。意味は 「min」 が 
「max」 よりも大きければ、 「min」 と 「max」 を入れ替えるという意味です （ 
<-> という演算子は、両側の変数の値を入れ替えるという意味です)。 

if 文はこのように （） の中に条件を書き、その次にブロックや文を書きます。 
条件が“真”のときのみ、ブロックや文を実行するという意味になります。 

ブロックは前の章でも少し紹介しましたが、詳しくは紹介してI、ませんでし 
たね。また、条件式についてもこの章で説明したいと思います。 



ブロックは { } で囲まれたものです。 TJS ではこの中に文をいくつも書く 
とができます。このようなブロックを、「複合文」と呼ぶこともあります。 


if 文では、 if 文の次にブロックを書いて、その中に「条件が“真”のときに 
実行する文」をいくつも書くことができます。ブロックの中に書かれた文は、 
ブロックの外に書かれた文と同じように、上から順に実行されます。 
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— 上記の例では、 _ 

iT(mm>max) { min く —〉 max; } _ ___ 」 

でしたね。これはブロックの中に一つしか文が入っていません。 

_これでも間違いではありませんが、実行する文が一つだけの場合は、 

IT (mxn>max) min <-> max;_ 

と書いても同じ意味になります。 

「文の最後には「;」（セミコロン）をつける」と前に言いましたが、ブロッ 
クの後の場合にはセミコロンは要りません。 

ブロックの中に複数の文が入っている例を見てみましよう。たとえば、 「 Mes - 
sageLayer . tjs 」 にある FprocessLinkJ という関数では、 
if (In. storage != ，丨丨丨 In. target ! = ’■) 

{ 

window. lockMessageLayerSelProcess () ; // 選択を ロック 
if(System ， getKeyState(VK—RETURN) || 

System.getKeyState(VK_SPACE)) 
window.hideMouseCursor(); 

// キーボー ドによる操作の場合はマウス カーソルを 隠す 
window, process (In • storage , In. target ,ln • count Page )； 


という if 文が使われています。 

if 文の次の中に複数の文が入っています。ここのブロックの中身は、 「 ln . stor - 
age != " Hln.target != n J という条件が“真”にならないと実行されないもので 
す。 


ちなみに、この章のタイトルが 「 if 文」となっていることでお分かりのよう 
に、ばも文です。普通の「式;」形式の文と同じように、 if も文としてブロック 
の中に書けます。上記の例でも if 文の次のブロックの中に if 文が入っているの 
が分かると思います。 

また、ブロックは、 TJS において重要な概念である「スコープ」というもの 
を決めるためのものでもあります。これは次章で説明します。 
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if 文 


else 


「もし〇〇ならば xx する」というののついでに、「さもなければ△△する」 
というのを書きたい場合があります。このときに使うのが 「 else 」 です。 


「 else 」 は 「 if 」 に続いて書きます。 

例を見てみましょう。 「 Utils . tjs 」 の 「 han 2 zen 」 という関数には以下のよう 
な if 文があります。 

if (num>=0x0020 && num<=0x7e) 

res+=$(Oxff00+num-0x20 )； // UNICODE 
else res+=str [i ]； 


これは、 「 num >=0 x 0020&& num <=0 x 7 e 」、 つまり 「 num 」 が 0 x 20 以上 0 x 7 e 
以下の場合に 「 res +=$(0 xff 00+ num -0 x 20);」 を実行し、そうでなかった場合は 
「 res += str [ i 】;」 を実行します。 

ほかにも 「 else 」 はよく使われていますから、見てみてください。 


else 


「もし〇〇ならば xx する、さもなくてもし△△ならば□□する、さもな 
くてもし▽▽なら…」のように、違う条件でいろいろなものを実行したい場 
合です。 


例はいろいろなところにありますが、 「 Utils . tjs 」 の 「 kansuuj し simple 」 を見 
てみましよつ。 

if (digit == "•") 

out += point ； 
else if (digit == 

out += minus ； 

else if (digit >= ' 0 ' && digit <= ' 9 ' ) 
out += digits[+digit]; 

else 

out += digit; 







US 
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壽#鬱參泰_ _ 

これは 、 「digit ==”•"」ならば rout += point ;」 を、 「 digitd n 」 ならば rout 
+= minus 」 を 、「 digit >= '〇 1 && digit <= ( 9 f J ならば rout += digits [+ digit ] 」を、 

最終的にこれらのどれにも合致しなければ [out += digit ] を実行するという意 
味です。 


■ if 演算子 


いままで説明したのは、「文」としての if ですが、「演算子」としての if もあ 
ります。 

if 演算子は、 「 AifB 」 と書いた場合、 「 B 」 が“真”の時のみ 「 A 」 を評価(実 
行)する演算子です。英語の if に近 t ゝ構文で if を使うことができます。 

KAG の TJS スクリプトにも、たとえば、 

absolute = +elm.index iT elm.index ! == void ; J 

のような形で出てきます。この場合は、 「 elm . index != void 」 の場合のみ 
「absolute = + elm . indexj を実行するという意味になります。 
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if 文の次の （） の中には「条件式」というのを入れます。条件式も式の一種 
ですが、とくに値と値の関係を調べ、結果が“真”あるいは“偽”になるも 
のをいいます。 


+演算子 

式の中で変数などにな 
んらかの処理を行なう。 


以下、条件式に使う演算子*を種類別に見て I ゝきましよう。 


同定演算子 


「同定演算子」は、値が同じか同じでないかを調べる演算子です。 


以下にこの類の演算子を示します。 


mmm 

使い方 

意味 

== 

a == b 

a と b が同じ場合に真。 

1= 

a != b 

a と b が同じでない場合に真。 

=== 

a === b 

a と b が型が同じで、さらに値も同じ場合に真。 

!== 

a !== b 

a と b の型が違うか、あるいは値が違う場合に真。 


「==」演算子と「==二」演算子、あるいは「!=」演算子と「!==」演算子の 
違いは、「型の一致」まで調べるかどうかです。 

たとえば、「==」演算子は「"4" ==4」のように文字列と数値を比較しても、 
その彳直が同じなので“真”になりますが、「”4" ===4」とすると、片方は文字 
列、片方は整数で、型が一致しないため、“偽”になります。「===」演算子や 
「!==」演算子はよく 「 void 」 との比較で使われますが、通常は「==」演算子 
のほうを使います。 


■ 比較演算子 


比較演算子は、値の大小の関係を調べるものです。 


演算子 

使い方 

二 

意味 j 

< 

a < b 

a が b より小さい場合に真。 

> 

a > b 

a が b より大きい場合に真。 

<= 

a <= b 

a が b と同じか、あるいは a が b より小さい場合に真。 

>= 

a >= b 

a が b と同じか、あるいは a が b より大きい場合に真。 
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:纖《激:ゼ)賴:讎蹄% 

錄參拳彙# _ _ 


二つの値が両方とも文字列型だった場合は 、 Unicode * における文字コード 
順での比較になります。 


論理 AND / OR 演算子 


「論理」とはこの場合は「“真”あるいは“偽”を扱う」という意味です。 
AND は「かつ」、 OR は「または」という意味です。 


演算子 

使い方 

I 

意味 

iSiiiiilii 

&& 

a&&b 

a かつ b の場合し真。 

II 

a lib 

a または b の場合に真。 


* Unicode 

ISO で定められた文字 
コード 体系。 一つの 体 
系で多言語文字を扱う 
ことができる。日本語 
版 Windows などで通常 
用いられている Shift 
JIS とは異なる。 


この演算子は両側に条件式を書いて使います。たとえば a が b と同じで、か 
つ、 c が d と同じである場合に“真”にしたい場合には、 


b && c 


d 


と記述します。 


b M 


d 


ならば、 a が b と同じか、あるいは c が d と同じ場合に、“真”になります。 


前に例としてあげた 「 MessageLayer . tjs 」 にある 「 processlink 」 の if 文にも 
rln.storage != " 11 ln.target !="」というのがありましたが、これは「 ln . storage 」 
が「"」でない場合、または 「 ln . target 」 が卩リでない場合、という意味にな 
ります。 


否定演算子 


「否定演算子」は、右側に書かれた条件式を「否定」する演算子です。否 
定とはどういうことかというと、“偽”ならば“真”、“真”ならば“偽”とい 
うように、真偽を逆にするということです。 


rmWT ] ~~I 

* 

! 


j a を否定 


「!」演算子の優先順位はかなり高くて、たとえば 「 a == b 」 という条件を否 
定したくて 「! a == b 」 と書いても正常に動いてくれません。これは f (! a ) == bj 
と同じ意味で、 a を否定したものが b と同じかどうかを調べてしまいます。正 
しくは 「!( a == b )」 と書く必要があります。優先 I 賴序で分からなくなったら、 
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if 文 

# 

馨 

カツコを使ってしまえば OK です。優先 II 頃序について詳しくは付録の「演算子 
一覧」をご覧ください。 


条件式と真偽 


if 文は、条件式が“真”を示したときに、後続の文やブロックを実行すると 
いう文でした。“偽”の場合にはまるっきり文やブロックを無視します。 

では、“真”と“偽”はどのように TJS で扱われているのでしょうか。上で 
述べた演算子の説明でも「真になる」や「真偽を逆にする」という表現を使 
いました。 

TJS は“真”と“偽”を以下のルールに従って使います。 


•条件演算子を使う演算子は“真”のとき「1」、“偽”のとき「0」になる。 
•数値としての「0」以外が“真”、「0」が“偽，’。 


真偽を表わす演算子は“真”の時に「1」になります。試しにコンソールか 
ら「5==5」と入力して enter キーを押してみましょう。「1」と表示されまし 
たね。「5 ==5」は明らかに“真”ですが、それが「1」という結果になったと 
いうことです。「5 ==4」の場合は「0」、つまり“偽”になったと思います。 

数値としての「0」以外が“真”で、「0」が “偽，， とはどういうことでしょう。 

真偽を逆にする！演算子で試して見ましょう。コンソールに「!!0」と入力し 
てみます。 

「!!」と、！演算子を 2 回使っているので、否定の否定、つまり逆の逆で真 
偽はそのまま、という意味になります。「じゃあ、意味ないじゃないか」と思 
うかもしれませんが、いったん TJS に真偽の解釈をさせるためにわざとこのよ 
うに書くことにします。 

「!!0」の場合、「0」は“偽”なので、結果は「0」、つまり“偽”になった 
と思います。では「!!1」と入力してみましょう。「1」は「0」以外の数値、つ 
まり真なので、結果は「1」になります。「!6」ではどうでしょうか。「6」は 
「0」ではないので結果は「1」、つまり“真”になります。 
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7-2 条件式に使う演算子 

_ # _ _癰_馨 

「0」以外の数値ならば「1」でも「2」でも「10⑻」もなんでも、“真”な 
のです。そのため、たとえば 「 if ( a ) b ;」 と書けば、 「 a 」 が「0」以外のときに 
「 b 」 を実行する、という意味の if 文になります。 

常に“真”を表わす 「 true 」 というもの、常に“偽”を表わす 「 false 」 と 
いうのがあって、真偽を表わす場合に「1」や「0」などと書くよりは分かりや 
すく書くことができます。 

ただし、真偽同士を比較してはいけません。たとえば A が“真”かどうかを 
調べるために 「 if ( A == true )」 と書いてはいけません。“真”は0以外の数値で 
あるとお話ししましたが、「4」でも“真”であるし、「-1」でも“真”、「5」で 
も“真”だからです。 「 true 」 は常に数値としては「1」なのですが、もし 「 A 」 

が「5」だったら、 [5 -=1 J の結果は “偽，’ になってしまいます。 A が“真” 

かどうかを調べたかったら、 「 if ( A )」 と書いてください。 
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「これはよく使うから目立つところにおいておこう」とか、「これは邪魔だ 
から使うまではしまっておこう」など、私たちの日常でも、なにか物を置く場 
所は一考するところです。 


TJS の変数などにも同じことが言えて、置く場所を適切にすればプログラム 
が読みやすくなったり、実行速度が増したり、コードの保守性が高くなります。 


* グローバル 

global 


* ローカル 
local 


変数を置く場所には大まかに2つあって、ひとつは「グローバルな位置」、 
もうひとつは「ローカルな位置」です。 

「グローバル*」 は「広域な」という意味ですが、そのとおり、 グローバル 
な位置に置かれた変数はその「見える範囲」、つまりスコープが広く、どこか 
らも見えるようになります。 

それに対し、「ローカル*」は「局所的な」という意味であり、そのスコープ 
は限られます。 


ではどのように書くと グローバルな 位置になり、どのように書くと ローカル 
な位置になるのでしょうか。 

カギは { }、つまり「ブロック」にあります。 


ローカル変数 


ブロックは前の章で複数の文をまとめる「複合文」の機能をお話しました 
が、実は単に複合文を作るだけではありません。スコープを作る、つまり見え 
る範囲を限定するという重要な機能があります。 


例を見てみましょう。 「 Utils . tjs 」 にある 「 han 2 zen 」 という関数は以下のよ 
うになっています。 

function han2zen(str) 

{ 

var res; 

var i ； 

for(i=0 ； iostr.length ； i++) 

{ 
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8-1 変数の スコープ13131 

_ _錐馨# _癱 

varnum 二 # str[i] ; 
if (num>=0x002 0 && numo=0x7e) 

res+=$(Oxff00+num-0x20 )； 
else res+=str [i ]； 

} 

return res ； 


ブロックが二つあり、しかも片方はもう片方の中に入っています。その中で 
変数が宣言されています。 


この変数のスコープを図示すると以下のようになります。 





function han2zen (str) 



—res 

n 

var res; 
var i; 

for { 一 0;KstrJength:i+.) 

i 





l 

^num var num=#str [i] : 

if (num>=0x0020 && num<=0x7e) 
res+=$ (0xff00+mim-0x20): 
else res+=str [i]; 

\ 




w } 

しよ 

return res; 


変数 res について見てみましよう。 


「 res 」 は外側のブロックの最初で宣言されています。 res * が見える範囲、 
つまり res のスコープはここで始まっています。そして、ブロックが終わる場 
所、この関数の最後で res のスコープが終わっています。 

試しに KAG を起動し(起動すると、この han 2 zen という関数はすでに定義さ 
れた状態になっています)、コンソールから res と入力してみましよう。「メン 
パ'" res " が見つかりません」といわれると思います。つまり、このブロックの 
外側では res は見えな I ゝのです。 


* res 
response 


ところで、上の図には変数 str というのがあります。 str は関数の引数です 
が、これ も 実は ローカル 変数なのです。この変数の スコープは 関数の始まりか 
ら終わりまでです。 
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スコープ 






# # # _囌雜 

ホ num 
number 


内側のブロックでも 「 nUm *」 という変数が宣言されています。この変数の 
スコープも、この変数を宣言したところから始まり、ブロックの終わりで終わ 
っています。内側のブロックが終わったあとでは変数 num は使えな t ゝのです。 


内側のブロック内で外側のブロックにある変数である 「 str 」 や 「 res 」 や 
「 i 」 を使っていますよね。このように、内側のブロックからは外側のブロック 
にあるものは見えるようになっています。ブロックが深くなれば深くなるほど、 
見える範囲が限定されていく仕組みです。 


グローバル変数 


では、ブロックの外側、つまりなんのブロックにも囲まれていない場所で変 
数を作るとどうなるでしょうか。答はそれは「グローバル変数」になり、どこ 
からもその変数が見えるようになります。 

KAG の TJS スクリプトでは、 「 Initializers 」 で多く見ることができます。た 
とぇば、 

var dm = Debug.message; 

というのがあります。これはどのブロックの中にも入っていない場所で宣言さ 
れた変数です。そのためこの 「 dm 」 という変数は、どこでも使うことができ 
るようになります。 


ローカル変数のススメ 


「クセーバル 変数は どこから も アクセスできて 便利だよね」…確かに そうです ね。「数 
の スコープがどこから 始まって どこで 終わって…」なんて気にする必要がありません。 

しかし、だからといって全部をグローバル変数にしてしまったらどういうこと 
が起きるでしょうか。たとえば KAG で使われて t ゝる変数の数はざっと1000個以 
上あります。中には同じ名前の変数もたくさんあって、これをすべてグローバル 
変数にしてしまったら、同じ名前がぶつかってしまい、大変なことになります。 

もちろん、グローノ{ル変数はグローバル変数なりに便利なところがあります 
が、どこからも見えるという必要がないならば、 ローカル 変数にするべきであ 
る、というのは TJS に限らず多くの言語で言われていることです。 グローバル 
変数と ローカル 変数、それぞれをうまく使 t ゝ分けるのがコツです。 
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8^2 関数の スコー 




關数 ( D ス3~プ 






スコープに 影響されるのは変数だけではありません。関数の スコープ も（変 
数のそれとは若干違いますが）あります。これらはあとで「クラス」の機能を 
説明するときに一緒に説明することになります。 

KAG の TJS スクリプトを見ると、いちばん外側のブロックの前に 「 class 」 
と書いてあって、そのブロックの中に変数や関数がたくさん書いてあると思い 
ますが、これが「クラス」です。このようなクラスを使わない場合は、関数は 
すべて グローバル 位置に宣言されると覚えておけば、今はよいでしょう。 


プ回 

_ _參泰 
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欣められた動作を繰り返し実行 U たいというとき 
のために、 TJS はいくつかの繰り返し(ループ)の 
方法を用意しています。ここで紹介するのはその 
うちのひとつの while 文と呼ばれるものです。 













〜-^している間中 


TJS にはいくつか繰り返し(ルーフ:)を作る構文がありますが、 while 文はその 
うちのもっとも簡単な形のものです。 

とりあえず例を見て見ましょう。 「 UpdateConfig . tjs 」 には、以下のような 
while 文があります。 

while (oldconf ig [ i ] ! 二 end—mark && i < oldconf ig. count) 

{ 

content += oldconfig[i] + "¥n"； - 
i++; 


while 文はこのように、まず 「 while 」 と書き、その （） 内に条件式を書きま 
す。その次には文またはブロックが来ます。上記の例ではブロックが書いてあ 
りますね。この条件式が“真”の間中、ずっとこのブロックを実行するという 
意味になります。 

でも、「“真”の間中」というのは少し誤解を招く表現かもしれません 。 while 
文の動作を詳しく見てみましよう。 


① まず条件式を評価し、これが“偽”ならば文やブロックを実行せずに次に進む。 

② 文やブロックを実行する。 

③ 条件式を評価し、“偽”ならば次に進み、“真”ならば②まで戻る。 


つまり、文やブロックを実行している途中にたとえ条件式が“偽”になって 
も、このループを抜けることはありません。常に条件式をチェックしているわ 
けではなくて、文やブロックを一回実行するごとにチェックしています。 

また、 while 文を実行しようとする時点ですでに条件式が“偽”になってい 
た場合は、文やブロックは1回も実行されないので、注意が必要です（後述の 
do 〜 while 文だと違います)。 

「ブロック」ではなく「文」を使った例も挙げましょう。同じ 「 UpdateCon - 
fig . tjsj にある while 文です。 

while (newconf ig [i] ! = ena_mark && i < newconfig. count) 

i + +; 








この場合は、 rnewconfig[i] != end—mark && i く newconfig.countj という条 
件が“真”である限り 「 i ++ 」 を実行するという意味です(ちなみに 「i ++ 」 と 
は 「i に1を加算する」という意味です)。 


break 文 


繰り返すのをブロックの途中でやめたい(ループの途中で抜け出したい）とい 
うときに使うのが 「 break 文」と呼ばれるものです。 

TJS 2 リファレンスにある以下の例を見て見ましょう。 
while(true) // break が実行されない限りは無限ループ 
{ 

if (f unc () ) break; // f unc () が真ならば while 終了 
func 2()； // T で break が実行されなければここにくる 

} 

// break が実行されると、ここにくる 


この while 文は、条件式に 「 true 」 が指定されています。条件が常に“真”、 
つまり、ループを抜け出そうとしなければ永遠に繰り返す、「無限ループ」と 
呼ばれるものです(無限ループは吉里吉里の実行を止めてしまうので、書いて 
はいけません)。 

ただ、この例ではループを抜け出すために break 文が書いてあります 。 break 
文が実行されるとブロックの残りの実行をせずに、すぐに while 文の次に実行 
を移します。なにか条件によってループを抜け出した^、場合がほとんどですか 
ら、 break 文は必ずといってよいほど if 文やそれに類するもので使われます。 


cormnue 文 


繰り返しの最初に戻りたいという場合に使うのが 「 continue 文」と呼ばれる 
ものです。 

例を見てみます。 


var i = 〇 ; 

whiled < 5) 










while 文 


funcO(); 

if (fund ()) continue; 

// fund () が true ならば 、 i < 5 の条件式チェックがされ、真ならば 
//またブロックの先頭から実行される 
func2() ; 

i + +; 


continue 文は、実行されるとブロックのそれよりも後を実行せずに、条件チ 
ェックに戻ります。その条件チェックが“真”ならば、またブロックの最初か 
ら実行されますし、“偽”ならば while ループから抜けることになります。 

continue 文も break 文同様、 if 文やそれに類するもので使われます。 


do 〜 while 文 


章の始めでもちょっとお話しましたが、 「 do 〜 while 文」というのがありま 
す。構文は以下のようになります。 

do 

文またはブロック 
white (条件式）； 


これは最初に条件チェックを行なわないことを除けば、 while 文と同じです。 
「 do 」 の時点で条件が“偽”でも、文またはブロックが必ず1回は実行されま 
す0 







for 文も繰り返しを行なう場合に使う文ですが、 
while 文や do 〜 while 文より複雑なプを作る 
ことができます。 














for 文 


for 文の使い方 


while 文や do 〜 while 文も for 文と同じく、繰り返しを行なうための文です 
が、 for 文はもうちょっと高機能なものです。 


いちばんオーソドックスな例を見てみましよう。 「 HistoryLayer . tjs 」 の 
「 displnit 」 という関数には以下のような for 文があります。 


for (i= 0 ；1 < dataLines:i-t 
ノ drawLine(i); \ 


(f) c 


i ) 


for の次の （） の中には「;」 （セミコロン） で区切られた 3 つの部分があるの 
が分かるでしょうか。前から順に、「第1節」「第 2 節」「第 3 節」と呼んでい 
て、それぞれ役割が決まっています。 

第 1節は、ループに入る前に実行する式を指定します。この例では、変数 
「 I 」に「0」を代入しています。 

第 2 節には条件式を指定します。 「 while 」 と同じで、ここの条件式が“真” 
であるあいだ中、文やブロックを繰り返し実行します。この例では、 「 i < 
dataLinesJ という条件が“真”である間実行されます。 

第 3節には、文やブロックの実行の1回ごとに実行する式を指定します。こ 
の例では、 「 i ++」、 つまり 「 i 」 に「1」を足しています。 

ところで、上で例に挙げた for 文はどのように動作するのでしょうか。 

変数 「 i 」 は最初に「0」になります。次に ri < dataLinesJ という条件がチ 
エックされます。 「 i 」 が 「 dataLines 」 よりも小さくない場合は、文またはブロ 
ックは1回も実行されません。 「 i 」 が 「 dataLinesJ よりも小さければ 「 draw - 
Line ( i ); J が実行されます。 

1回、文またはブロックが実行された後は 「 i +十」が実行されます。 「 i 」 に 
「1」が加算されます。そしてまた条件がチヱックされ、 「 i 」 が 「 drawLine 」 より 
も小さい場合はずっと 「 drawLine ( i )」 と 「 i +十」が実行されることになります。 







for 文の使い方 

lEfifl 

翁## _ _雜_ 

たとえば、 「 dataLines 」 が「4」の場合は、 「 i 」 は「0」「1」「2」「3」と変化 
しながら 「 drawLine ( i )」 が4回実行されます。「5」ならば、「0」「1」「2」「3」 

「4」と変化しながら5回実行されます。つまり、 「 dataLines 」 で指定した回数 
だけ、 「 drawLine ®」 が実行されることになり、しかも 「 i 」 は「0」から順に 
1ずつ繰り上がってます。 


for 文は、このように何かを指定回数ぶんだけ実行したいというときによく 
使われるものです。使い慣れないうちは、「節のどれがどういう機能だったか 
な？」と分からなくなってしまいがちですが、そのうちに while 文よりも書く 
のが楽になってくるでしよう。 


上記の例は while 文を使えば、以下のように書くこともできます。 



for 文を while 文に書き直した例をお見せしましたが、 for 文中の continue 文 
は while 文中のそれと違うので、注意が必要です。 


while 文の 「 continue 」 は、ブロックの残りを実行せずに条件判断に戻るも 
のでしたが、 for 文の 「 continue 」 は、第3節を実行してから条件判断に戻り 
ます。 


例を見てみましょう。「 MessageLayer . tjs 」 の「 intemalAssign 」 という関数 
には、以下のような for 文があります。 
for(var i = si.count-1 ； i>=0 ； i--) 

{ 

if (si[i] === void) continue; 

( 略） 
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參雜 _ 雜 _ _ 


continue が実行されると、 「 i —」 が実行されて、 「 i >=0」 という条件式がチ 
エックされ、もし条件が真ならば、再びこのブロックが実行されます。 

このように for 文における continue 文は、「文やブロックの実行の1回ごとに 
実行する式」を忘れずに実行してくれます。 


節の var 


第1節に 「 var 」 が書いてある for 文を見掛ける と 思います。 たとえば、 
「 Utils . 句 s 」 の「 numberjormat 」 関数には以下のような for 文があります。 
for(var i = 0 ； i < n—len; i++) 

{ 

var digit = n[i]; 

if (digit >= 'O' ScSc digit <= ' 9' ) n_digits ++; 
else if (digit == ' . ' || digit == ' e') break; 


どのような変数を使う 
かあらかじめ決定する 
こと。 


「 var 」 をこのように第1節に書くと、この時点で変数を宣言*できます。こ 
の変数のスコープは for 文の終わりまでです。つまり、 for 文が終わった時点で 
この変数 「 i 」 は使えなくなります。これはループだけに用いる変数を使うの 
に便利です。 
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switch 文 


switch 文の使い方 


switch 文は、ある値があって、その値がどの値と同じ時にどのような処理を 
するかを書き連ねることができるものです。 

例を見てみましょう。 「 Utils . tjs 」 に 「 str 2 num 」 関数がありますが、そこに 
ある switch 文です。 
switch ( ch ) 

{ 

case ，_ 0 " : res+= " 〇 ; break ; 
case ，， 1": res+=”i，_; break ; 

(略） 

case " — : res+=" - ，， ； break ; 
case " —: res+ 二"-， , ； break ; 
default ： res+=ch; break; 


switch の後の （） の中には式を書きます。この式の結果が、 「 case 」 の後に 
書かれたものと一致する場合、その 「 case 」 のところの文が実行される仕組 
みです。たとえば、 「 ch 」 が "0" ならば、 「 res +="0”； break ;」 という文が実 
行されます。 

「 default :」 は、どれにも当てはまらなかった場合に実行されるものです。 


switch 文に 3$ ける break 


上記の例で、いちいち break 文が書いてあるのに注目してください。 break 
文は、ループで用いる 「 break 」 と同じように、この文が書かれた時点で switch 
文を抜けます。 break 文を書くと switch 文を抜けるということは、 break 文を 
書かなかった場合は抜けないということです。その場合は、次に書かれた 
「 case 」 の内容を実行してしまうので、注意が必要です。 








TJS 2 はオブジェクト指向的な考え方でプ□グラ 
ミングができる言語です。この章では、「オブジェ 
クト」の概念や使し、方について説明します。 
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オブジェクト 


# 
參 


參參春##參 



オブジェクトとは 1 ? 






「データ型」 のと ころで、 TJS の扱えるデータ型には種類がいくつかあると 
話したと思います。ほかの言語を知っている方の中には、そこに挙げたデータ 
型の中にはいくつか足りない型、たとえば「配列型」が無いので、「配列型は 
どうなるんだ」などと思った方もいるかもしれません。 


「オブジェクト*」は英語で「もの」という意味で、特に何か特定のものを 
具体的に示す単語ではありません。 TJS におけるオブジェクトも、なにか特定 
の「これ！」といったものではありません。実際オブジェクトと言われるもの 
の種類はけっこう多くて、先に説明した関数もオブジヱクトの--種ですし、後 
で説明するクラスもオブジェクトの一棟であり、 fid 列や辞書配列もそうです。 


実際のところ、いろいろなデータのうち、文字列型でも数値でもオクテット 
列型でも void でもなければ、それはオブジェクト型で、 TJS から見ればオブジ 
ェクトとして扱われるものなのです。 


メンバ選択演算子 


* メンバ オブジヱ外は、たいていメンバ*を持っています。「メンバ」とは、そのオブジェク 

member 卜が持っている変数や関数や他のオブジェクトなどのことです。 TJS は、そのメ 

ンバにアクセスするために「メンバ選択演算子」というものをもっています。 


たとえば、 “Helloworld!” のところで、以下のような式を使いました 3 
System.inform("Hello world!") 


この 「System.inform」 というところに注目してください。 「System」 の次に「•」（ド 
ット）が書 t ゝてあって、次に 「inform」 と書 t 、てありますね c この「•」（ドット）ば「直接 
メンバ 選択演算子」 といいます。左側に書いたオブジェクトの中の、右側に書いた 
メ ンバに アクセスするよ、という動作をする演算子です。この場合は 「System」 と 
いうオブジェクトの中の 「inform」 というメンパにアクセスする、という意味です， 
日本語の「の」と考えるとわかりやす t 、でしよう。 「Systerri の inform」 なのです。 

メンバ選択演算子にはもうひとつ、「間接メンバ選択演算了」というのもあ 
りますが、これは次の章の辞書配列のところで説明します。 
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12-1 オブジェクトとは？ | 


曝_ _籲雜參參 


2-2 


オプジ I クトの騸類 


へノ 


TJS が扱えるオブジェクトについて紹介します。 


TJS が持っているやや 特殊な オブジェクトとして、 「グローバル. オブジェク 
卜*」というのがあります。 グローバル •オブジェクトは グローバル位置に 宣 
言されたもの、つまり グローバル 変数や普通の関数などをもっているオブジヱ 
クトです。これには 「 global 」 でアクセスすることができます。 


* グロー バル 
エクト 

global object 


オブジ 


たとえば、グローノ《ル位置で以下のような変数を宣言したとします。 
var foo = j >; _ 


この変数 「 foo 」 はグローバル変数として宣言されました。実は、この時点 
でグローバル•オブジェクトは 「 f 00 」 というメンバをもつことになります。 

試しに、スクリプト•エディタで 「varfoo = 5;」と入力して実行してみてく 
ださい。次に、コンソールで 「 global . foo 」 と入力してみてください。「5」と 
表示されるはずです。 

逆に、 「 global.foo = 1」とコンソールに入力すれば、変数 「 foo 」 は「1」と 
いう値をもつことになります。コンソールに 「 foo 」 と入力してみてください。 
「1」と表示されたはずです。 


また、今までたびたび使ってきた 「 System . inform 」 の 「 System 」 というのも 
「 global 」 のメンバです。ですから、たとえば rSystem . inform (" Helloworld! 1 ');J 
を fglobal . Systeminform( n Hello world !");」 としてもちゃんと動きます。 


■関数とプロパティ 


関数もオブジェクトとして扱われます。オブジェクトは変数に入れることが 
できるので、変数に関数を入れてアクセスするようなことができます。 

たとえば、以下のようなスクリプトを書くことができます。_ 

function add (a , b) { return a+b; } 
var foo = add ； 

System.inform(too(2 # 3)); 

この例では、変数 foo に関数 add を代入しています。すると、 foo があたかも 
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ォブジェクト 



攀 

関数であるかのように使えるようになります。 


* プロパティ 

property 

特性 


「プロ/\°ティ 勹というのは、ここでは説明しませんが、一見変数のように見える 
関数のようなものです。変数のように値を設定したり、値を取り出したりできま 
すが、そのときに関数のように特定のスクリプトを実行することができるものです。 


クラスとオブジェクト 


「クラス」は14章で詳しく説明しますが、オブジェクトを作るためのひな 
形のようなものです。どのような種類のオブジェクトを作るか、どんな変数が 
あってどんな関数を持っているのか、を知っているのが「クラス」です。 

実は、クラスそのものもオブジェクトの一種です。 C ++ などの言語ではクラ 
スは「型」として扱われ、オブジェクトとは厳しく区別されるのですが 、 TJS 
では同じ種類のものとして扱います。クラスを変数に入れてほかの関数に渡 
し、そのクラスからオブジェクトを作るといった使い方もできます。 


配列と辞書配列 


TJS においては、配列もオブジヱクトの一種です。配列が番号で要素を管理 
するのに対し、名前で要素を管理する「辞書配列」というのもあります。ど 
ちらも次の章で詳しく解説します。 


_文字列に対する操作 


オブジヱクトに対してメンバ選択演算子を使うとそのメンバにアクセスする 
ことができると話しました。しかし実は、文字列や文字列の入っている変数に 
対しても、メンバ選択演算子を使うことができます。文字列は TJS においては 
オブジェクトではないのですが、擬似的にまるでオブジェクトであるかのように 
メンノ《選択演算子を使うことができます。 


たとえば、文字列の長さを表わす 「 length 」 というメンバがあります。試し 
にコンソールから 「〃 abc 〃. length 」 と入力してみましょう。文字列 「” abc 〃」 は3文 
字の長さがありますから、「3」と表示されたと思います。もちろん、変数に対 
しても同じで、たとえば変数 「 hoge 」 に r M abc H J という文字列が入っていれ 
ば、 「 hoge . length 」 は「3」になります。 

文字列に対する操作はいくつか便利なものがあります。 「 TJS 2 リファレン 
ス」を見てみてください。 
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大量のデータを使いたいときに、その数だけ変数 
を分作っていたら大変です。効率良く大量のデー 
夕を処理したいと思ったら、配列』を使し、ましょう。 
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配列 


_ #籲參_翁 


画 


p ■議(:汶從_穩__»_____^ 


麵 


「配列」は、大量のデータを、通し番号をつけて管理できるものです。た 
とえば、1000個のものを記憶したいからと言って変数を1000個宣言していた 
ら大変なことになります。配列を使えば、配列の中にその1000個を入れてお 
くことができます。 


* オブジェクト 
object 

氺クラス 
class 


* 筆者注 

new Array 〇;の代わり 
に[】；としても配列ォブ 
ジェクトを作成できま 
す。 


TJS では配列もオブジェクト*です。配列は 「 Array 」 というクラス*から作 
られるオブジェクトです。「クラス」は、簡単にいうとオブジェクトを作るた 
めのひな形なのですが、これは次の章で詳しく説明します。 


配列の作成 


配列は使う前に「配列オブジヱクト」を作らなければなりません。配列オブ 
ジヱクトを作るには、 new 演算子を使って、以下のようにします。 
var ar = new Array ()； 


このように rnew Array 0; J とすることで配列オブジェクトを作ることがで 
きます。上記の例では、変数 ar にそのオブジヱクトを入れています。 


配列のアクセス 


配列の各要素は、「0」から始まる通し番号で管理されます。この通し番号 
を添え字と呼びます。添え字を指定するには [] 演算子(間接メンバ選択演算 
子)を使います。 


たとえば、 

以下のように使います。 

ar [0] = 

"zero 11 ； 

ar[l] = 

"one" ; 

ar[2] = 

" two ，，； 


この例では、〇番目に 「 n zero "」 を、1番目に 「" one 11 」 を、2番目に 「" two 11 」 
を入れています。この状態でたとえば rSystem . inform ( ar [ 0 ]) J とすれば 
「 zero 」 と表示されることになります。 
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何も値が代入されていない要素は 「 void 」 であると見なされます。 







i 3 - v 配列 wa 

參響 着參參翁# 


配列の大きさ 


配列の要素数(配列の大きさ）は count プロパティで参照できます(プロパテ 
ィはオブジェクトのメンバで、変数のようなものです)。 

たとえば、上記の例の要素数を確かめたかったら、コンソールか何かで 
「 ar . count 」 としてみましょう。 ar 変数に入っている配列オブジェクトのもって 
いる要素数である「3」と表示されるはずです。 「 ar . count 」 になにか値を入 
れても要素数を変えることができます。 


j 配列の大きさは、その配列に代入するときに使った添え字のいちばん大きな 

" ものになります。上記で言えば 「 ar [2]」 がいちばん大きいですから、要素数 

H は「3」になります（添え字は「0」から始まっていることに注意してください)。 

配列の大きさは好きなだけ大きくできますが、そのぶん、大きなメモリが必 
要です。 
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TJS 2 は「辞書配列」と呼ばれるものもサポートします。辞書配列も配列の 
一種ですが、こちらは通し番号で管理するのではなくて、「名前」で管理しま 
す。名前に結び付けられた値を取り出す様子から「連想配列」などと呼ばれ 
ることもあります。 


* 筆者注 

new DictionaryO ； の代 
わりに%[];としても配 
列オブジェクトを作成 
できます。 


辞書配列の作成 


辞書配列を作るには、普通の配列と同じように new 演算子を使い、以下の 
ようにします。 

var die = new Dictionary () ; 


辞書配列のアクセス 


配列の場合は、要素のアクセスに [] 演算子を指定しました。辞書配列の場 


合 も同じです。 

die [’zero'] = 0 ; 
die [’one ， ]=1; 
die [’two ’ ] = 2 ； 


これは r ' zeroM という名前の要素 ( zero という名前のメンバ）に「0」を、 
r ' one ' J という名前の要素に「1」を、卩 two 1 」 という名前の要素に「2」を代 
入しています。この状態で 「 System . inforrrKdicrzero ’]);」 とすれば、「0」と表 
示されるはずです。. 

名前は重複することはありません。たとえば、この状態で 「 dicrzerol ="ぜ 
ろ”;」とすれば、 「 dierzero 1 ]」 という要素の内容は「”ぜろ叫に置き換わりま 
す。 「 f zero f 」 という名前の要素が2つになるわけではありません。 

要素を削除するには delete 演算子を使います。たとえば [delete dicl ' two *];] 
とすれば、 rwj という名前の要素を削除できます。 


初めて使われた名前の要素には 「 void 」 が入っているものと見なされます。 
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KAG の変数と辞書配列 


さて、前に KAG の変数は辞書配列であると話しました。実は 「 f 」 や 「 sf 」 
は辞書配列なのです。たとえばゲーム変数 「 f . hoge 」 は、 「 f 」 という辞書配列 
の [" hoge 」 という名前をもった要素にアクセスしていたのでした。 


辞書配列回 

_______ 


「あれ？辞書配列の要素には [] 演算子でアクセスするんじゃないの？」と 
思うかもしれません。「」（ドット）は直接メンバ選択演算子、 [] は間接メンバ 
選択演算子です。直接か間接かの違いはあっても、両者は同じ仲間の演算子 
なのです。「直接メンバ選択演算子」は、「」の右側にメンバの名前を「直接 
的に」書いてアクセスします。それに対し、「間接メンバ選択演算子」は、 [] 
の中にメンバの名前を文字列として「間接的に」書いてアクセスします。 


「直接メンバ選択演算子」を使うと 「 f . hoge 」 と書くことができますが、 
「間接メンバ選択演算子」を使うと rf [ f hoge f ] J とかけます。両者はまったく 
同じ意味になります。 


「間接メンバ選択演算子」の利点は、 [] 内に変数を指定できるということ 
です。たとえば、「 var name =” hoge ";」 として、「 name 」 という変数には 
「，， hoge "」 という文字列が入っているとします。そこで 「 f [ name ]」 と書けば、 
rf[ M hoge ,! ]J と同じ意味、つまり 「 f . hoge 」 にアクセスできるのです。 
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配列や辞書配列をコピーしたい場合には、どのようにすればよいでしょう 
か。配列に限らないことなのですが、 TJS はオブジェクトを「参照」という方 
法で扱います。 



配列をコピーしたいとして、たとえば以下のようにしてみましよう。変数 
「 ar 」 には配列オブジェクトを入れて、それを変数 「 dar 」 にコピーしたいとし 
ます。 


var ar = new Array ()； 

ar [ 0] = " zero' 1 ； ar[l] = "one" ; ar [2 ] 二 

="two n ； 

var dar = ar; 



はたしてこれで良いのでしようか。結論から言うと、これでは馬太目なのです。 
試しにこのスクリプトをスクリプト • エディタから実行してください。その 
後、コンソールから 「 ar [ 0 ]」 の内容を確かめてください。 「" zero 叫と表示さ 
れたと思います。では、 「 dar [0】 パぜろ n 」 とコンソールから入力し、 rdar [0 ]J 
に「”ぜろ"」を入れます。その後、またコンソールから 「 ar [0]」 の内容をみて 
みてください。「"ぜろ”」になっていると思います。つまり、コピー先の内容 
を書き換えたはずが、コピー元の内容も書き換わってしまっているのです。 


これは、 TJS が「オブジェクト」を「=」（イコール)演算子や関数の引数へ 
の引き渡しなどでほかの変数などに入れるときに、「コピー」ではなくて「参 
照」を増やすという方法で行なうからです。これは配列に限らず、 TJS がオブ 
ジェクトとして扱うもの全部に言えます。 


米国のベル研究所で開 
発された高級言語。 
UNIX における標準開発 
言語。 


「参照」は C 言語などの言語を使っている方には「ポインタ」の方が分か 
りやすいかもしれません。実体となるオブジェクトがあって、それを「指し示 
す」、つまり参照する変数が増えるだけなのです。 

上記の例でいえば、 「 newArrayO 」 で作ったオブジヱクトの実体はまず 「 ar 」 
という変数から参照されています。しかし、そのあと 「 dar 」 という変数から 
も参照されます。結局、 「 ar 」 も 「 dar 」 も同じオブジェクトを指し示している 
ことになるのです。 
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オブジェクトは r 參照」されている 


配列の コピー 


配列を本当にコピーしたい場合は、配列の 「 assign 」 というメンバ関数を使 
う必要があります。 

上記の 「dar = ar ;」 は以下のようになります。 
var dar = new Array ()； 
dar.assign(ar); 


まず、 「 dar 」 に新しい配列オブジェクトを作って入れます。そのあと、その 
新しい配列のメンバ関数である 「 assign 」 を呼び出し、 「 ar 」 の内容をコピー 
します。これで、 「 dar 」 に 「 ar 」 の内容がすべてコピーされるのです。 


■辞書配列のコピー 


辞書配列のコピーはちょっとやっかいです。辞書配列オブジヱクトは作られ 
た直後はメンバを何も持っていないからです。 「 assign 」 というメンバさえあり 
ませんので、上記の配列と同じ方法は使えません。 

どうするのかといえば、たとえば 「 ddic 」 という変数に 「 die 」 という辞書 
配列をコピーしたければ、 
var ddic = new Dictionary (); 

(Dictionary.assign incontextof ddic) (die )； 

と書く必要があります。 

ややこしいですが 、 f Dictionary . assignJ という関数を、コピー先である 
「 ddic 」 というオブジェクトに対して呼び出しています。引数にはコピー元の 
辞書配列を指定します。とりあえずはこのように書くものだ、と覚えておけば 
よいと思います。 
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クラス 


クラスはオブジェクトを作るための、いわば「ひな 
形」です U オブジェクトの役割や性質を決める「ク 
ラス]につし VC 説明します。 
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クラス 


癰猶# _黪# 


[ESI 

TJS には琴 


クラスとは7 
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S には多くの種類の「オブジェクト」があるという話をしました。しかし、 


その「種類」はどのように決定されるのでしょうか。 

そのカギを握るのが、「クラス」と呼ばれるものです。クラスはオブジェク 


卜の「ひな形」のようなものです。 TJS では通常、オブジェクトを作るときに 
この「クラス」を用いて作ります」オブジェクトの「種類」やその「性質」を 
決めるものが、クラスなのです。 


KAG の TJS スクリプトを見ると 「 class 」、 つまり「クラス」を表わす表記 
がよく出てくると思います。事実、 KAG ではほとんどの記述が class に続くブ 
ロック内に書いてあります。 KAG を理解するにはこの「クラス」を知り、才 
ブジェクトとどう関わりがあるのかも知ることが重要です。 



比較的独立していて分かりやすい例が 「 YesNoDialog . tjs 」 にあるので、見 
てみましよう。ここには 「 YesNoDialogWindow 」 というクラスが定義されて 
います。このクラスは「はい」か「いいえ」を ユーザに 選択させるためのウイ 
ンドウを作るためのひな形です。 KAG では終了しようとするときに「終了し 
ますか？」と表示されますが、あれを辺っているのがこのクラスから作られた 
オブジェクトなのです 9 


このクラスの構造は、大まかに以下のようになっています(一部省略してあ 
ります)。 


class YesNoDialogWindow extends Window 
{ 

var yesBut ton; 
var noButton ； 
var result = false; 

function YesNoDialogWindow (message, cap) 
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super.window ()； 
(略） 





i _ _ _ 馨癱# 

} 

function finalize () 

{ 

super, finalize (...); 

} 

function action (ev) 

{ 

(略） 

} 

function onKeyDown ( key, shift) 

{ 

super. onKeyDown ( ...) ; 

(略） 

} 

} 

クラスは 「 class 」 から始まるブロックです。この中に、このクラスから作 
られるオブジヱクトがどのようなメンバをもつか、すなわちどのような性質を 
もつかを記述することになります。 
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* 宣言 

どのような変数を使う 
かあらかじめ決定する 
こと。 


* メソッド 

method 


* 筆者注 

実際には「プロパティ」 
というのも記述できま 
すがここでは説明しま 
せん。 


クラス 
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class に続くブロック中には、変数や関数を書くことができます。 


メンバ変数 


クラスでは、オブジェクトが作られるときに、そのオブジェクトがあらかじ 
めもつ変数、「メンバ変数」を宣言*できます。記述の方法は普通の変数と同 
じで、 「 var 」 を使って宣言します。 


メンバ関数(メソッド) 


オブジェクトがもつ関数を宣言することもできます。記述の方法は普通の関 
数と同じで、 function を使って宣言します。「メンバ関数」のことをよく「メ 
ソッド*」とも呼びます。 

メンバ関数の中では、オブジェクトのメンバ変数にそのままアクセスするこ 
とができます。オブジェクトのメンバ変数には「」（ドット）演算子を使う、と 
書きましたが、自分自身のオブジヱクトのメンバ変数にアクセスする限りは、 
その必要はありません。 

たとえばメンバ関数 「 action 」 には 「result = true ;」 や 「result = false ;」 と 
いう記述がありますが、この result はメンバ変数ですね。クラス内で 「 var 」 を 
使って宣言されている変数です。 
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オブジェクトの作成と削除 


クラスそれ自体は単なるひな形なので、実際にはこれからオブジェクトを作 
らなければなりません。オブジェクトを作るには、今までにも出てきましたが、 
「 new 」 を使います。クラス 「 YesNoDialogWindow 」 からオブジヱクトを作っ 
ている部分が、 「 YesNoDialog . tjs 」 にあるので、見てみましょう。 

この関数 「 askYesNo 」 は、先ほどのクラスを使って指定されたメッセージ 
を表示し、ユーザーに「はい」か「いいえ」を選んでもらう関数です。 


function askYesNo (message, caption = •• 確認"） 

{ 

var win = new YesNoDialogWindow(message, caption )； 
win.showModa 丄 （ 〉 ； 
var res = win.result ； 

invalidate win ； 
return res ； 


「 new 」 は演算子で、 「 new 」 の次に書いたクラスから、オブジヱクトを作 
る、という意味になります。ここでは [ newYesNoDialogWindow 」 としてい 
ますね。その次に （） があって、この中には「コンストラクタ*」（後で説明し 
ます)に渡す引数を指定します。 

作ったオブジェクトは変数 win に入ります。 「 win . showModalO 」 では、作 
ったオブジェクトの 「 showModal 」 という関数を呼び出しています。 

「var res = win . result ;」 では、作成したオブジェクトのメンバ変数である 
「 result 」 を変数 res に入れています。このメンバ変数は、先ほどのクラス内で 
「 var 」 を使って宣言したものです。 


* コンス トラクタ 
constructor 


3ンストラクタとは 


「コンストラクタ」は日本語では「構築子」と呼ばれるもので、特別なメ 
ンバ関数です。オブジヱクトが作られるときには、必ずこの関数が呼ばれます。 

コンストラクタは「クラス名と同じ名前になる」という特別なルールがあり 
ます。先ほどのクラス rYesNoDialogWindowJ にも 「 YesNoDialogWindow 」 
という関数がありますが、これがコンストラクタです。 
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new 演算子にはコンストラクタに渡す引数を指定する、といいました。メンバ関 


数 「 YesNoDialogWindow 」 には 「 message 」 と 「 cap 」 という2つの引数がありま 
す。先ほどの関数 「 askYesNo 」 では、この引数を 「 new 」 で指定したのです。 


卜を削除する 


オブジェクトは作ったら「削除」しなければなりません。幸い、 TJS は作ったオブ 
ジ x クトは自動的に削除されます(例外もあります)。「配列」の章で「参照」とい 
うお話をしました。この「参照」がすべてなくなる、つまりオブジェクトがどこか 
らも参照されなくなると、作られたオブジェクトは自動的に「削除」されます。 


削除と無効化 


オブジヱクトが削除される前に、 TJS では「無効化」という段階を踏みま 
す。「無効化」とは、「そのオブジェクトは使えない」、つまり「そのオブジェ 
クトは無効」とすることです。 

無効化は削除の前に必ず起こるもので、削除が自動的に起こる場合は無効 
化も自動的に起こります。しかし、意図的にオブジェクトを無効化させること 
もできます。それが invalidate 演算子です。 

先ほどの関数 askYesNo にもありました 。 「invalidate win ;」 として、変数 win 
が参照しているオブジヱクトを無効化したのです。 

無効化するとそのオブジェクトはもう使えなくなります。あとはそのオブジ 
ェクトは TJS によって自動的に削除されるのを待つだけとなります。 


* 筆者注 

ォブジ I ク トをすぐ 
に削除し ない ことで実 
行効率を上げる仕組み 
のことを「ガベージ • 
コレクション」といい 
ます。 


削除のタイミング 


参照がすべてなくなるとオブジェクトは自動的に削除されるといいましたが、こ 
れはちよっと嘘なのです。実は参照がすべてなくなってもオブジェクトが即、削 
除される保証はありません。 TJS は参照がすべてなくなってもオブジヱクトをすぐ 
には削除しないのです*。削除のタイミングが分からない、ということになります。 

これは実行効率を上げるための工夫なのですが、これが災いすることがあり 
ます。自動的に削除が起こる前に自動的に無効化が起こるのですが、削除の 
タイミングが分からないということは、この無効化のタイミングでさえ、予測 
できないものとなるのです。 

無効化は削除と違い、後述の finalize メソッドを呼び出すことがあり、この 
関数が呼ばれるタイミングが予測できないというのが問題になる場合がありま 
す。そのため、明示的に invalidate 演算子を使っておけば、確実にその時点で 
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オブジェクトを無効化し、 finalize メソッドを呼んでおける、ということになるのです。 


invalidate 演算子を使うか否かは難しいところですが、一応、「作ったオブ 
ジェクトは 必ず invalidate する」と覚えておけばよいでしよう。ただし、 「Array」 
や 「Dictionary」 クラス、 つまり配列や辞書配列などや、正規表現を使うため 
の 「RegExp」 クラス、「例外*」の 際に使う 「Exception」 クラスな どは、 
「invalidate」 を使わず、無効化も TJS 側に任せてしまうことがよくあります。 
これらは無効化時には特にこれと いって 何も しないので 「invalidate」 を使わ 
なくても特に問題がないのです。それ以外は、普通は 「invalidate」 を使います。 


* 例外 

通常の処理中では考え 
られない、例外的なエ 
ラーな どの処理。 


finalize メソッ 


オブジェクトが無効化されるときに呼ばれるのがこの 「finalize」 というメン 
バ関数、 「finalize メソッド」です。オブジェクトが無効化、つまり「このオブ 
ジェクトは使えない(使わない)」とされるときに呼ばれる関数ですから、ここ 
には「後処理」、つまりオブジェクトの後片付けの処理を書くことになります。 

「finalize メソッド」は、「コンストラクタ」とは反対の動作をするという意 
味で、「デストラクタ」（、消滅子）と呼ばれることもあります。 


卜を作らないクラス 


「クラスはオブジェクトのひな形である」と話しましたが、例外があって、 
ひな形として機能しないクラスもあります。 

クラスもオブジェクトの一種なのですが、このクラスというオブジェクトの特徴と 
して、クラス内で宣言したメンバ関数をすべてメンバとして持っているというこ 
とが挙げられます。通常はメンバ関数は、そのクラスから new 演算子でオブジ 
ヱクトが作られることを想定して書きますが、そうでなく、クラス内に単に関数 
をいくつか書けば、その関数群をクラスという形でまとめることができるのです。 

「吉里吉里」が提供しているいくつかのクラスがそれで、たとえば今までに何度 
か 「System.inform」 の开多で紹介した 「System」 というのも、実はクラスなのです。 

ただし、 「System」 はクラスだといっても 「newSystemO」 のような使い方 
はしません。 「System」 というクラスは「吉里吉里」本体や、「吉里吉里」が 
実行されている環境に関する情報を取得したり、設定したりするためのクラス 
で、単にこの機能に属する関数をクラスの形にまとめただけのものなのです。 
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クラスに関する非常に重要な概念として「継承」というものがあります。ク 
ラスはオブジヱクトの「種類」や「性質」を決めるものですが、継承によって 
引き継がれるのは、この「種類」や「性質」です。 


私たちの世界でもこの継承という概念は多くに当てはまります。 

私たち人間を考えてみましょう。私たち「人間」は「ほ乳類」ですね。「人 
間」は、子が母の母乳で育つという「ほ乳類」の性質を「継承」しています。 
その「ほ乳類」は「動物」の「よく動いて活動する」という性質を「継承」 
しています。その「動物」は「生きている」という「生物」の性質を「継承」 
しています。私たち人間は、生物であり、動物であり、ほ乳類であり、人間 
であり、継承元の性質をすべて引き継いでいるのです。 

また、「生物—動物—ほ乳類-人間」という順では、より「抽象的」な「生 
物」から、より「具体的」な「人間」へと継承されていっているのが分かる 
と思います。 

TJS のクラスもほかのクラスの性質を「継承」することができます。たとえ 
ば、先ほどの rYesNoDialogWindowJ というクラスは、 「 Window 」 というク 
ラスを「継承」しています。 Window は「吉里吉里」が提供するクラスで、い 
わゆる「ウィンドウ」のひな形です。 「 YesNoDialogWindow 」 は、この「ウイ 
ンドウである」という性質を継承しつつ、「『はい』 か 『いいえ』かを ユーザー 
に選択させるためのウィンドウ」という性質をもつひな形なのです。 


■ 継承に関する用語 


継承に関する用語はいくつかあります。 


•継承元の(より抽象的な）クラスを「親クラス」あるいは「スーパークラス」 
と呼びます。 

•継承した（より具体的な）クラスを「子クラス」あるいは「サブクラス」と呼 
びます。 

• クラスを継承させることを「親クラスから子クラスを派生する」とも呼びます。 
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継承のしかた 


クラスをクラスから継承させるには、 「 extends 」 を使います。先ほどのク 
ラス fYesNoDialogWindowJ の class 宣言のところを見てください。 


class YesNoDialogWindow extends Window 
となっていますね。これは 「 YesNoDialogWindow 」 を 「 Window 」 から継承 
させる、つまり 「 Window 」 から 「 YesNoDialogWindow 」 を派生させていま 
す。 

こうすることで、 YesNoDialogWindow から作成されたオブジェクトは、 
Window クラスのメンバもすベてもつことになります。 


先ほどの関数 「 askYesNo 」 の中で、 「 win * showModalO ;」 というのがあり 
ました。 「 showModal 」 は 「 YesNoDialogWindow 」 内で定義されていないメ 
ンバ閔数なのでいったいどうしたものか、と思った方もいるかと思いますが、 
これは実は Window クラスに属するメンバ関数で、「ウインドウを表示し、そ 
のウインドウが閉じるまで、ほかのウインドウへのアクセスを禁止する」とい 
う機能をもったメンバ関数です」 


継承とコンストラクタ 


先ほどのクラス 「 YesNoDialogWindow 」 のコンストラクタ、つまり関数 
「 YesNoDialogWindow 」 を見てみてください D 


super.Window () ； 

とありますね。この super は「スーパークラス」、つまり[親クラス」を表わ 
すものです。 

親クラスは Window クラスですが、 Window クラスにもコンストラクタがあ 
り、その名前はクラス名と同じ 「 Window 」 です。つまり、この 「 s 叩 er . Win - 
dowO 」 は、親クラスのコンストラクタである Window というメンバ関数を呼 
んでいるのです。 

このように、クラスを継； pc したら、その親クラスのコンストラクタを、子ク 
ラス内のコンストラクタから呼ばなければなりません。 


271奢 








継承と finalize 


finalize メソッドも、親クラスのものを呼ばなければなりません。クラス 
「 YesNoDialogWindow 」 の 「 finalize 」 にも以下の記述があります □ 


super.finalize(...); 


ここで親クラスの 「 finalize 」 というメソッドを呼び出しています。関数の引 
数のところにある「...」（ドット3つ）は、この関数に渡された引数をそのまま 
別の関数に引き渡す、という意味です。実際には仕様として 「 finalize 」 には 
引数は何も渡されないのですが、慣用的にこのように書いています。 


才—パ-ライ 


継承に付随する、これまた重要な概念として丨オーバーライド」というもの 
があります。 

オーバーライドは「優先する」という意味で、この場合は「子クラスのメン 
バ関数が親クラスのメンバ関数に優先する」という意味です。 

どういうことかというと、チクラスでは親クラスにあるメンバ関数と同名の 
メンバ関数を宣言できます。このとき、親クラスのメンバ関数は+クラスのメ 
ンバ関数に隠されてしまいます。 


先ほどのクラス 「 YesNoDialogWindowl の 「 onKeyDownl という関数を見 
てみてください。同名の関数は「，ぎ里吉里2」のリファレンスを兄ても分かる 
とおり、親クラスの Window クラスにもあります。このようにすると、作られ 
たオブジェクトの 「 onKeyDown 」 というメンバ関数は、子クラスの 「 onKey - 
Down 」 になり、親クラスの 「 onKeyDown 」 ではなくなるのです， 

隠された親 クラスの メンバはどうなるんだ、ということになりますが、これ 
は親 クラスを 表わす super で アクセスで きます。 クラス 「 YesNoDialogWin - 
dowj にも 「 super . onKeyDown (•..);」という記述があります。これは親クラス 
の 「 onKeyDown 」 を呼んでいるのです 3 


そういえば 「 finalize 」 もそうですね。丨 finalize 」 も親クラスの 「 finalize 」 を 
オーバーライドする形で書き、その中で親クラスの同名のメソッドを呼びます。 
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オーバーライドは、親クラスのメソッドの性質を変えたいが、名前はそのま 
まにしたい(あるいは名前をそのままにしなければならない)、という場合によ 
く使います。よく使うのは「イベント」、つまり「吉里吉里」側から呼ばれる 
メンバ関数を記述するときで、「吉里吉里」が提供するクラスにはあらかじめ 
動作が決まったメンバ関数が定義されています。動作が決まった、といっても 
ほとんどは「何もしない」という動作ですが、この動作を変えたいときに、そ 
のメンバ関数をオーバーライドして動作を記述する、ということを行ないます。 

先ほどの 「 onKeyDown 」 は「キーが押された」ときに呼ばれるメンバ関数 
ですが、クラス 「 YesNoDialogWindow 」 ではこのメンバ関数をオーバーライ 
ドして、キーが押されたときに特別な処理ができるようにしてあります。 

オーバーライドできるのはメンバ関数だけで、 TJS ではメンバ変数はオーバ 
ーライドできません。子クラスで親クラスと同じ名前のメンバ変数を作ると、 
親クラスのメンバ変数と子クラスのメンバ変数が同じものとして扱われ、 「 super 」 
を使ってもアクセスできなくなるので、注意が必要です。 
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この章では、 KAG の構造と、 KAG や吉里吉里が 
どのように動作するのかの概要をお話しします。 



























KAG の構造と動作 
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KAG がどのような構造になっていて、どのような動作をするかについて、概 
要をお話しします。 


System フオルダのファイル 


KAG の System フオルダにあるフアイルは、以下のようになっています 


LineBreak.asd 

行末クリック待ち記号用アニメ ーション定義ファイル。 

PageBreak.asd 

ページ末クリック待ち記号用アニメーション定義ファイル。 

checking 

チェック•ボックスのチェック記号 （ 「 CheckBoxLayer . tjs 」 で使用>〇 

LlneBreak.png 

行末クリック待ち記号用画像。 

LineBreak 一 apng 

行末クリック待ち記号用アニメーション • セル画像。 

FageBreakpng 

ページ末クリック待ち記号用画像。 

Pa § eBirea_png 

ページ末クリック待ち記号用アニメーション • セル画像。 

AnimationLayer.tjs 

11 :; 

アニメーションの進行を管理するコンダクタ用クラス 
r AnimationConductorJ とともに、アニメーシヨンを行なう機能を 
持ったレイヤのクラスである 「 AnimationLayer 」 を定義する。 

BGM.tjs 

BGM を管理するクラス BGM と、それに必要な諸クラスを定義する。 

ButtonLayer.tjs 

ボタンとして動作するレイヤ•クラス 「 ButtonLayer 」 を定義する。 

Config,tjs 

KAG の設定ファイル。 

CtieckBoxLayer.tjs 

チェック•ボックスとして動作するレイヤ•クラス 「 CheckBoxLayer 」 

を定義する。 

.パ':: ナノ: 卜 . ： : . : . ' 

Conductor's 

':ン -V ンぐ、...へへ.：…… 

... フ：.' 

KAG のシナリオやアニメーションの進行を管理するための「コンダ 
クタ」の親クラス 「 BaseConductor 」 と、シナリオ管理用のコンダ 
クタ•クラス 「 Conductor 」 を定義する 0 

, . :ノ： v へ . ， .. ", 

DefaultMov © r 4 js 

レイヤの自動移動の「動き」を管理するクラスである 「 LinearMover 」 

と 「 SplineMover 」 クラスを定義する （ move タグで使用 ） 〇 

EditLayer.tjs 

単一行ェディット(文字入力欄)用レイヤクラス 「 EditLayer 」 を定義する。 

•' •' - .... 

v ： -； v . .:：•：/ : ：；•；；--■ 

' ぐ..'.. : : : . 

GraphicLayer.tjs 

. ■ • . 

KAG の背景レイヤや前景レイヤの親クラスである 「 GraphicLayer 」 

と、背景レイヤ用クラスである 「 BaseLayer 」、 前景レイヤ用クラス 
である「 CharacterLayerJ を定義する。 

Hi _ Lay _ 

メッセージ履歴レイヤ用クラスを定義する。 

lnitialize,tjs 

システムの初期化を行なうプログラム。 「 start 叩 . tjs 」 はこのファイ 
ルを実行するだけのものである。 

KAGtayer.tjs 

KAG で用いられているレイヤクラスすベての親クラスである 「 KAGLayer 」 

を定義する。 

MainWindow.tjs 

. .一.’:'.ぐ::……. て 

KAG のウィンドウを管理するクラスである 「 KAGWindow 」 を定義 
する。 KAG の動作の多くがここに記述されている。 

Menut^s 

メニュー項目の定義を行なう。 

MessageLayer.tjs 

. - ....... • 

KAG のメッセージ-レイヤを管理するクラス 「 MessageLayer 」 を 
定義する。 













15-1 吉里吉里/ KAG の構造と動作 


Movie^s 

動画再生を管理するクラス 「 Movie 」 を定義する。 

PKtgin 雄 

KAG 用プラグインの親クラスである 「 KAGPIugin 」 を定義する。 

SMs 

効果音を管理するクラス rSESoundButferJ を定義する。 

UpdateCponllg.^s 

rconfig . tjsJ を古いバージョンのものから引き継ぐためのプログラム。 

UtilUjs 

いくつかのユーティリティ関数を定義する(乱数発生、漢数字変換など ） a 

YesNoDiaiog^s 

「はい」「いいえ」をユーザに選ばせるためのクラス FYesNoDialog - 
Window 」 とそれを使うための関数を定義する 3 


ィベント駆動型 


「吉里吉里」でプログラミングをするときには、「イベント駆動型」という 
プログラミングの仕方をする必要があります。イベント駆動型のプログラム 
は、普段は待ち状態にあります。そこで「キーが押された」だとか、「タイマ 
一の時間切れが来た」だとか、「マウスが動いた」など、いろいろな「イベン 
卜」が発生します。それに反応する形でいろいろと動作の記述を行うのが「イ 
ベント駆動型」と呼ばれるものです。このようにイベントに反応して動作する 
プログラムの部分のことを、「イベント•ハンドラ」と呼びます。 


*イベント駆動 
イベントドリブン 
(event driven) とも呼ば 
れる 


「イベント駆動型」に対する言葉として、「手続き型」という言葉がありま 
す。手続き型ではプログラムをあらかじめ決められた手続きに従って、頭から 
順に実行します。 KAG のシナリオは、手続き型のプログラムです。 


イベント駆動型のプログラミングにはデメリットとメリットがあります。イ 
ベント駆動型のプログラムは、たとえば GUI のアプリケーションのように 「0 K 
ボタンが押された」や「メニュー項目が選択された」など、多種多様なイベン 
卜が発生する可能性のあるプログラムの記述に向いています。しかし、とくに 
「何かを待つ」という動作の記述が煩雑になりやすいというデメリットもあり 
ます D 


KAG のシナリオ，ファイルのように、機能を次々と順を追って実行するよ 
うな用途では手続き型が適していますが、 KAG のシステムそのもののように、 
GUI を構築する用途としてはイベント駆動型が適しています。 

KAG のシステムは、 KAG のシナリオ.ファイルに記述された手続き型のシ 
ナリオを実行するシステムであり、それ自体はイベント駆動型で記述されてい 
るというわけです。 
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KAG の初期化の過程は I Initialize . tjs 」 に書いてあります。 flnitialize . tjs 」 の 


実行が終わると制御は「吉里吉里」に戻り、「占里吉里」は次のイベントが発 
生するまで待ちます。何かイベントが発生すれば、「吉里吉电」は TJS で記述 
されたイベント応答の関数である「イベント•ハンドラ」を呼び出します u 
「 Initialize . tjs 」 の実行が終わると、次のイベントが発牛するまで待つ…と 
いっても、実際はすぐに 「 first . ks 」 の実行が始まるので不思議に思うかもしれ 
ません。実はこれは、 「 Initializers 」 を実行し終えた迫;後、最初のシナリオの 


開始を告げるイベントが KAG 内部で発生するため、 「 firsLks 」 がすぐに実行さ 
れて t ゝるように見えるのです。 


イベント•八ンドラ 


イベントに反応して記述される関数、それがイベント.ハンドラです u ウィ 
ンドウやレイヤなど、「吉里吉里」が提供するクラスにはよく 「 on 」 から始ま 
るメンバ関数があります。これらがイベント•ハンドラです。通常はこれを継 
承したクラスでオーバーライドすることでイベント.ハンドラを記述します。ど 
のようなイベント•ハンドラが記述できるのか、 r 吉里吉里2リファレンス」 
の「クラスリファレンス」を参照してみてください。 


たとえば、「 Menus . tjsJ には「 Menultem 」 クラスを継承した「 KAGMenu - 
Item 」 というクラスが定義されています。このクラスはウインドウ上部に並ん 

でいるメニュー項目を管理するクラスですが、このメンバ関数に、_ 

function onClick() 

{ 

Super.onClick (...)； 
click(); 


というのがあります。これが「イベント•ハンドラ」です。この 「 onCIick 」 
というのは、 メニュー 項目がクリックされたときに呼び出されるイベント•ハ 
ンドラです。ここでは 「 clickO ;」 として、同じクラスのメンバ関数である click 
を呼んでいます。また、イベント•ハンドラでは通常このように親クラスの同 
名のメソッドを呼び出します。 


* 筆者注 

" action " メソッドを 
呼び出すタイプのイべ 
ントの処理の方法もあ 
ります。 


KAG の System フオルダにある TJS スクリプトを見ても、よくこの on から始 
まる関数が使われているのが分かると思います。 
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個 


TJS から KAG の機能に直接アクセスすることができます。 KAG で記述でき 
る範囲のことは KAG のシナリオで記述し、それで物足りなくなったら TJS で 
「吉里吉里」や KAG 内部の機能に直接アクセスできる、というのは、「吉里吉 
里/ KAG 」 の大きな特徴です。 


「 Initialize.tjsJ と fKAGWindowJ 


rinitialize . tjsj は KAG の初期化を行なうプログラムです。ほかの各スクリ 
ブトの読み込みや二重起動の防止のほか、 「 f 」 や 「 sf 」 などの KAG 変数ァク 
セス用の変数の定義も行なっています。 

その中で変数 「 kag 」 にクラス 「 KAGWindow 」 から作ったオブジェクトを 
入れて I ゝる場所を見付けてみてください。 


KAG メインウインドウの作成 


var kag ； 

kag = new KAGWindow (); 


ここですね。この変数 kag は、 KAG のウインドウ（普段私たちがゲームなど 
の作品と接しているあのウインドウ）そのものです。 

この 「 KAGWindow 」 というクラスには KAG の動作のほとんどが定義され 
ていて、多くの KAG の管理するオブジェクト、たとえば背景や前景レイヤ、 
メッセージ.レイヤ、 BGM や効果音用のオブジェクト——などもこの変数 
kag からアクセスできることになります。 

変数 kag に入っているのはひな形となるクラス 「 KAGWindow 」 そのもので 
はなくて、クラスから作られたオブジェクトであることに注意してください。 

「 KAGWindow 」 には 「 process 」 というメンバ関数があります。これは 
KAG のシナリオの実行を開始するための関数です。 rinitialize . tjsj の最後で 
は、 
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first .ks の実行 


kaq.process ( h first .ks") ; __ 

となっていて、メンバ関数 「 process 」 を呼んでいます。ここから 「 first . ks 」 
の実行が始まるのです。 


ウインドウ 


「吉里吉里」は、 「 Window クラス」でウィンドウの機能を提供しています。 
「 KAG 」 では、 「 MainWindow . tjs 」 で 「 KAGWindow 」 というクラスを、また 
「 YesNoDialog . tjs 」 で 「 YesNoDialogWindow 」 というクラスを定義してんゝます。 

メイン.ウィンドウは、前述の 「 Initializers 」 で KAGWindow クラスから 
作られています。また、バージョン情報ダイアログも同じ KAGWindow クラス 
のオブジヱクトです。 


レイヤ 


「 Layer クラス」でレイヤの機能を提供しています。「レイヤ」はウィンド 
ウ内に表示されるもので、何かウィンドウ内に表示しようと思ったら、必ずレ 
イヤを作る必要があります。 

• 背景レイヤ 

「背景レイヤ」は、以下の式でアクセスできます。 


kag . fore.base 

表画面の背景レイヤ 

kag.bacK.base 

裏画面の背景レイヤ 


背景レイヤは rGraphicLayer . tjsJ で定義されている 「 BaseLayer 」 クラスの 
オブジェクトです。 

「吉里吉里」のレイヤ管理はレイヤを親子関係で階層的に管理します。そ 
の階層のトップ、すべてのレイヤの親にあるのが、「プライマリ.レイヤ」と 
呼ばれるものです。 KAG の場合、「表背景レイヤ」が必ずプライマリ • レイヤ 
になります。 

レイヤの階層は、 KAG のウィンドウをアクティブにして 「 Shift + F 12」 を押 
すことでコンソールに一覧表示されるので見てみてください。 
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レイヤは 「 Layer クラス」から継承されています。たとえば Layer クラスに 
は、レイヤを色で塗りつぶす 「 fillRect 」 というメソッドがあります。 

これを使って表背景レイヤを真っ赤に塗りつぶすには、 _ 

kag.fore.base -fillRect{ 0, 0, 640, 480 ， Oxf f 0000 ) ;_ 

とします。各引数の説明は「吉里吉里2リファレンス」の 「 Layer クラス」の 
該当メソッドを参照してください。 

• 前*!レイヤ 

「前景レイヤ」は、以下の式でアクセスできます。 



表画面の前景 n 番のレイヤ 

ka^ackJayersN 

裏画面の前景 n 番のレイヤ 


たとえば、 「 kag . fore . layers [0]」 ならば「表画面の〇番の前景レイヤ」とい 
う意味になります。 

「前景レイヤ」は「 GraphicLayer . tjs 」 で定義されている 「 CharacterLayerJ 
クラスのオブジェクトです。この「 CharacterLayerJ クラスも Layer クラスか 
ら継承されているため、 Layer クラスの各メソッドが使えます。 

• メッセ_ジ•レイヤ 

「メッセージ.レイヤ」は、以下の式でアクセスできます。 



表画面の n 番のメッセージ•レイヤ 

1 kag . back . messages [ n ] 

裏画面の n 番のメッセージ • レイヤ 


たとえば、 Lkag . back . messages [0]] ならば「裏画面の0番のメッセージ • 
レイヤ」という意味になります。 

メッセージ.レイヤは「 MessageLayer . tjs 」 で定義されている「 Message - 
Layer 」 クラスのオブジェクトです。 


BGM と効果音 


「吉里吉里」は 「 Wave ( PCM )」「 MIDI 」「 CD - DA 」 のいずれかでサウンド 
を再生することができます。 KAG の場合は BGM にこれらの3つのうちのどれ 
か一つを選べます。効果音には Wave ( PCM ) のみ使ことができます。 
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「 BGM 」 や「効果音」には、以下の式でアクセスできます。 


kag.bgm 

BGM 

kag . se [ n ] 

n 番の効果音バッファ 


BGM を管理するクラス 「 BGM 」 は、 「 BGM . tjs 」 で定義されています。た 
とえば “ test . wav ” を BGM として再生させたい場合は、 
kag.bgm.play (% [ storage : "test.wav "]) ； 

で再生できます。 — ——— 


「効果音」を管理するクラス 「 SESoundBuffer 」 は 「 SE . tjs 」 で定義されて 
います。たとえば “ test . wav ” を効果音として効果音バッファ〇番で再生した 
^、場合は、 

kag.se [0] .play (% [ storage : "test .wav 11 ]) ； 

とします。 


タグ•八ンドラ 


TJS から KAG のタグの機能を呼び出した t ゝ場合はよくあります。 

KAG のタグの多くは「タグ.ハンドラ」という、各タグに応じた関数を呼 
び出すことでその機能を実現しています。 

タグ.ハンドラは 「 MainWindow . tjs 」 の最後のほうにあり、 「 getHandlers 」 
という関数内に、 

タ グ名： function (elm) 

{ 

( ここに処理の内容） 

} incontextof this _ 

という形式で書き連ねてあります。引数 「 elm 」 では、タグの属性が辞書配列 
になったものを受け取ります。 

「 getHandlers 」 はこれらタグ名とそれに対応する関数の辞書配列を返すだ 
けの関数で、この関数の戻り値は変数 「 tagHandlers 」 に入れられます。つま 
り、 「 kag . tagHandlers 」 から関数を直接実行してやればよいのです。 
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暴# _靡# _ _ 


たとえば、 

@ image storage 二 hoge.jpg layer 二 base page 二 fore 
というタグと同様の機能を TJS から呼び出した t 、場合は、 
kag.tagHandlers.image( % [ storage : "hoge opg n ,layer : 
"base ”， page : "fore"]); 

と記述します。 「％[]」 の中に、 

属性名：属性の値 

という形式で属性をカンマで区切って指定して渡すことで、属性名を名前と 
し、属性の値をそれに対応する値とした辞書配列を渡すことができます。 


山每者:す 

%□内に辞書配列のメ 
ンバとなるものを記述 
して辞害配列を作成す 
る方法を使います。 


TJS からタグ•ハンドラの機能を呼び出す場合、「何かを待つ」という種類 
のもの、たとえばトランジシヨンの終了を待つ 「wt タグ」や時間待ちをする 
「wait タグ」などは正常に呼び出すことができないので、注意が必要です。こ 
れらを待つには、これらの完了を知らせるイベントを何らかの方法で受け取る 
必要がありますが、難しくなります。 


KAG を T JS か5操作するときの注意点 


KAG は「菜」に多くの情報を保存しますが、 KAG が菜に保存しないような 
情報を TJS 側から操作すると、その情報は粟に保存されません。 

たとえば、背景レイヤや前景レイヤでは「レイヤにどの画像が読み込まれて 
いるか」の情報しか菜に保存されません。なので、たとえばレイヤに直接何か 
を描画しても、その情報が栗に保存されないため、菜を読み込んだときにその 
ときの情報が復元されないことになります。この場合は、次の「菜を保存可能 
なラベル」を通過する前にそのレイヤに別の画像を読み込むなどして、 KAG 
が菜に保存できる情報のみの状態に戻しておく必要があります。 
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KAG は、 KAG 用プラグインを TJS で書くことができる機構をもっています。 
これにより、 KAG に簡単に機能を追加できるようになります。 


KAG のプラグインは、 「KAGPlugin クラス」からクラスを継承して作りま 
す。 KAG には「雪プラグイン」や「スタッフロール•プラグイン」などが付 
属していますが、それらのソースを見ても KAGPlugin から何らかのクラスが派 
生しているのが分かります。 

プラグインは、おおむね以下の構造を持っています。 


• KAGPlugin から派生したクラス本体 
• そのプラグインを KAG のシステムに登録する部分 
• プラグインを使用可能にするためのタグ(マクロ)の定義 


通常は 「first.ks」 （最初に実行されるシナリオ • ファイル)の最初でプラグイ 
ンのフアイルを呼び出して使います。 


KAGPlugin のメンバ関数 


「KAGPlugin」 には、「吉里吉里」本体から呼び出されるいくつかの関数が 
あります。たとえば 「onRestoreJ は、莱をたどるときに呼び出されるメンバ 
関数で、これをオーバーライドして処理を書けば、菜をたどるときに実行した 
い処理を書くことができます。 

以下に「吉里吉里」本体から呼び出される関数の説明をします。また、説 
明の中で、 KAG に付属している「雪プラグイン」である 「snow.ks」 の内容に 
ついても例として説明します。 

• finalize 

KAGPlugin クラスの finalize メンバ関数は、通常のクラスでの動作と同じく、 
オブジェクトが無効化されるときに呼び出されます。プラグインが後述の 
「kag.addPlugin」 で KAG のシステムに追加されると、 KAG の終了時に rfinal- 
ize」 が呼ばれるようになるので、ここに何か終了処理を書くことができます。 
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「雪プラグイン」では、作成したオブジヱクトを invalidate 演算子で無効化 
しています。 

• onSto 「 e(f, elm) 

onStore は菜を保存する際に呼ばれます。 KAG は「保存可能なラベル」 （ 「 I 」 

付きのラベル）で菜をいったん内部に保存するので、保存可能なラベルを通過 
するごとにこの関数が呼ばれることになります。 

引数 「 f 」 は、保存先の菜データを表わす辞書配列です。 KAG の菜が辞書配 
列なのは前に話したと思いますが、この 「 f 」 も辞書配列です。ここに何か辞 
書配列のメンバを作って情報を記録しておけば、 「 onRestore 」 で同じ情報を 
読み出すことができます。 

(なお、引数 「 elm 」 は、現バージョンでは使われていません)。 

たとえば、「雪プラグイン」では以下のような記述になっています。 


function onStore (f , elm) 


{ 

// 呆を保存するとき 


var die = f.snows = 

%[]； 

die.init = timer 

. == void; 

die.foreVisible = 

foreVisible; 

die.backVisible = 

backVisible; 

die.snowCount = snows.count; 

} 


rf.snows = %[] J の部分で、 「 f 」 に 「 snow 」 という名前のメンバを作ってい 
ます。そこに新しい辞書配列オブジヱクトを作っています。 KAG のシステム 
は、菜のデータに辞書配列や配列が入っていると、その辞書配列や配列の中 
身も保存するので、このような書き方ができます。 

変数 「 did にもその新しい辞書配列オブジェクトを入れています。「=」演 
算子はこのように続けて書くと、いちばん右側に書いたもの（この場合は％[】） 
をそれぞれに代入する、という動作をします。 

「 die 」 や ff - snowj の中身ですが、前に「参照」について話したとおり、 
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このようにすると 「 f . snows 」 と 「 die 」 は同じ辞書配列オブジヱクトを参照す 
るようになります。 

関数の残りの部分では、その 「 die 」 にいろいろと情報を記録しています。 


• onStableStateChanged(stable) 

「 onStableStateChanged 」 は、「安定」あるいは「走行中」の状態が変わっ 
たときに呼ばれます。引数 「 stable 」 は「安定」のときに“真”、「走行中」の 
ときに“偽”になります。 

KAG は状態として大きく分けて、「安定」と「走行中」の2つの状態をもっ 
ています。 

「安定」とは、 「 s 」 あるいは「1」あるいは 「 p 」 タグで停止中の状態で、ユ 
ーザーは菜の保存やメッセージ履歴の閲覧などをすることができます。一方、 
「走行中」とは、それ以外の状態で、シナリオが実行中であることを示してい 
ます。 

これらの状態が切り替わるときにこのメンノ s ' 関数が呼び出されます。 

何か走行中ではやりたくないことがあるときにこの関数を書けば、その状態 
を知ることができます。 

なお、「雪プラグイン」ではこの関数を使っていません（記述は空です)。 


• onMessa 目 eHiddenStateChanged(hidden) 

「 onMessageHiddenStateChanged 」 は、メッセージ.レイヤが「メッセー 
ジを隠す」のメニュー項目などで隠されるときと、その状態から抜けるときに 
呼びされます。引数 hidden は、メッセージ.レイヤが隠されるときに“真”、 
再び現れるときに“偽”になります。 

これは、たとえばプラグインでレイヤを表示していて、それをメッセージと 
一緒に隠したいときなどに利用することができます。 

• onCopy し ayer(toback) 

「 onCopyLayer 」 は、 「 backlay 」 タグあるいは 「 forelay 」 タグが実行された 
とき、あるいはトランジシヨン終了時に、裏画面の情報を表画面にコピーする 
必要があるときに呼ばれます。引数 「 toback 」 は、「表—裏」のコピーのとき 
に“真”、「裏—表」のコピーのときに“偽”になります。 

KAG のトランジシヨンの動作はかなりややこしいので後述します。 
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「雪プラグイン」では、以下のような記述になっています。 



function onCopyLayer (toback) 

{ 

//レイヤの表—►裏情報のコピー 

//このプラグインではコピーすべき情報は表示 • 非表示の情報だけ 
if (toback) 

{ 

//表—裏 

backVisible = foreVisible ； 

} 

else 

{ 

//裏—表 

foreVisible = backVisible ； 

} 

resetVisibleState ()； 


メンバ関数 「 foreVisible 」 と 「 backVisible 」 はそれぞれ、「表画面の雪粒」 
あるいは「裏画面の雪粒」が表示状態であるかどうかを表わしています。雪プ 
ラグインは雪粒を表示するためのレイヤを、表背景レイヤと裏背景レイヤそれ 
ぞれを親にして、表画面と裏画面両方に作りますが、それぞれの可視•不可 
視の情報をもっているのがこれらのメンバ変数です。 

「 toback 」 が“真”の場合は 「backVisible = foreVisible 」、 “偽”の場合は 
「 foreVisible = backVisible 」 を実行します 0 「 resetVisibleState 」 メンバ関数は、 
「 foreVisible 」 および 「 backVisible 」 変数の内容を実際に各雪粒のレイヤの表 
示状態に反映させるメンバ関数です。 


• ontxchangeForeBackO 

「 onExchangeForeBack 」 は、トランジションの終了によって、裏画面と面 
画面の情報を入れ替える必要があるときに呼ばれます。 

トランジションの動作につ t ゝては後述しますが、このメソッドが呼ばれる時 
点でレイヤのツリー構造は、表画面と裏画面が入れ替わっています。 
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「雪プラグイン」では以下のように記述されています。 


function onExchangeForeBack () 

{ 

//裏と表の管理情報を交換 

var snowcount = snows , count ； 

Tor(var i = 0; i < snowcount ； i++) 

snows [i] . exchangeForeBack () ； // move メソッド 

を呼び出す 


ここでは、各雪粒を管理するオブジヱクト （ SnowGrain クラスのオブジェク 
卜）の 「 exchangeForeBack 」 メンバ関数を呼んでいます。 SnowGrain クラス 
の「 exchangeForeBack 」 は以下のような記述になっています。 


function exchangeForeBack () 

{ 

//表と裏の管理情報を交換する 
var tmp = fore; 
fore = back ； 

.back = tmp ； 


「 fore 」 は表画面に表示されている雪粒のレイヤ、 「 back 」 は裏画面に表示 
されている雪粒のレイヤです。それを交換しています。 

トランジションの終了時には裏画面と面画面がそっくり入れ替わっているの 
ですから、このようにレイヤの情報も交換しないと、たとえば、いままで表画 
面に表示されていたと思っていた雪粒が実は裏画面に表示されていることにな 
っていた、ということになってしまいます。 


• onSaveSystemVariablesO 

「 onSaveSystemVariables 」 は、システム変数に情報を確実に保存するため 
のタイミングを提供します。システム変数は、 KAG が終了し、再び起動して 
も同じ情報を保っている変数で、何かシステムに関わるような(菜とは独立し 
た)情報を記録しておくのに便利です。 

この関数内で 「 kag . scflags 」 に何かメンバを作り、そこに情報を記録してお 
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くことができます。 「 kag . scflags 」 は辞書配列オブジヱクトです。 

「雪プラグイン」にはこの関数はありません。 


プラグインの登録 


プラグイン•クラスを作ったら、そのオブジェクトを作って KAG のシステムに登 
録しなくてはなりません。登録するには、 「 kag . addPlugin 」 メンバ関数を使います。 


「雪プラグイン」では以下のようになっています。 


kag. addPlugin ( global . snow_obj ect = new SnowPlugin (kag ))； 
// プラグインオブジヱクトを作成し、登録する 


「 global . snow_object = new SnowPlugin ( kag ) 」として SnowPlugin クラスの 
オブジェクトを作り、グローノ{ル•オブジェクトのメンバ 「 snow _ object 」 に 
入れています（このように書くと、 「 global 」 に 「 snow _ object 」 というメンバ 
が自動的に作られてからオブジェクトへの参照が代入されます)。 

「 global . snow_object = new SnowPlugin ( kag )」 という部分式が 
「 ka g , addPlugin 」 への引数になっていますが、「=」演算子それ自体は左辺（こ 
の場合は 「new SnowPlugin ( kag ) J ) を返すのでこの引数には新しく作った才 
ブジェクトが渡ることになります。 

この一行を複数行で書くと、以下のようになります。グローバル位置で宣言 
した変数はグローバル.オブジェクトのメンバになることに注意してください。 


var snow—object = new SnowPlugin(kag); 
kag.addPlugin(snow_object )； 


プラグイン•オブジヱクトは二度以上登録してはなりません。二度以上登録 
しないために、「雪プラグイン」では TJS スクリプトを定義する iscript タグを、 
以下のような if タグで囲っています。 


ypeof (global.snow 一 ob] ect) == undefined 
「 typeof ( global . snow _ object )」 は、グローバル•オブジェクトの snow—object 
メンバが表わしている型を表わす式ですが、グローバル.オブジェクトに 
fsnow _ objectJ が無ければ “ undefined ” になるので、それを利用して、すでに 
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グローバル • オブジェクトに snow _ object ^ ンバがあるかどうかを確認しています。 

iscript タグ内では最後のほうで snow^object メンバを作って値を入れている 
ため、何度実行してもこの iscriDt タグは 1 回限りの実行となります。 


マクロの登録 


プラグインを KAG から便利に使うため、「雪プラグイン」ではマクロをいく 
つか定義しています。定義は以下のようになっています。 


；マクロ登録 

©macro name=" snowmit H 

@eval exp 二 " snow—object •init ( 丄 7 , mp) ’’ 

@endmacro 

@macro name="snowuninit" 

@eval exp 二 ” snow 一 object.uninit() H 
@endmacro 

@macro name 二 ,, snowopt n 

@eval exp="sn 〇 w—object•setOptions(mp)” 

@endmacro 

マクロの 中に eva l タグが入っているのに注目してください。 eval タグは exp 
属性で指定された TJS 式を実行するタグです。 

たとえば snowopt マクロでは以下の TJS 式を実行しています。 


snow 一〇 toject•setOptions(mp) 


ここで 「 mp 」 はマクロに渡された属性が入った辞書配列を表します。 
たとえば snowopt タグを以下のように使うと、 
alse forevisible=true 


「 mp 」 が参照している辞書配列のメンバ 「 backvisible 」 は “ false ”、 rfore - 
visible 」 は “ true ” になります。 

「 snow _ object 」 は SnowPlugin クラスから作られたオブジェクトで、「 setOp - 
tions 」 メンノ《関数にこの辞書配列を渡していることになります。 

このように、プラグイン • オブジヱクトへは簡単にマクロの属性を渡すこと 
ができます。 
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吉里吉里/ KAG のトランジシヨンの動作 


プラグインでなにかレイヤを作って使うときに、 KAG のトランジシヨンの動 
作について知っておかなければなりません。 

「吉里吉里/ KAG 」 のトランジシヨンの動作はかなりややこしいです，ここ 
では、 trans タグで、「 layer = basechildren = truej 、つまり背景レイヤとその p レ 
イヤも含めたレイヤに対してトランジシヨンを行なう埸合について説明します。 


まず、 KAG のレイヤの構造ですが、表画面は「表背贵レイヤ」を，裏画面 
は「裏背景レイヤ」を頂点とした「親子関係」（階層構造)となっています。 

トランジシヨンの動作は、表画面に表示されている内容が、裏画面に表示 
されている内容に、時間をかけて切り替わる、ということですね。最終的に、 
表画面と裏画面の内容は両方とも、「トランジシヨン前に裏画面だったもの」 
の内容になります。 

トランジシヨン中で、切り替わっている間に、レイヤの構造はどうなってい 
るのかというと、表示の状態は変化しているとはいえ、実は構造には変わりは 
ありません。いまだ表画面は表画面、裏画面は裏画面のままです。 

構造に変化が起こるのは、トランジシヨンが終了する瞬間です。トランジシ 
ヨンが終了した時点では画面はまるっきり裏画面の状態になっているのですか 
ら、レイヤの構造的にも裏画面にしなければなりません。 


「吉里吉里/ KAG 」 はこのとき、以下の動作をします。 


① 「吉里吉里」は、表背景レイヤとその子レイヤたち、それと裏背景レイヤ 
と子レイヤたちを、そっくりそのまま、入れ替える 

② 「吉里吉里」は、トランジション前に表背景レイヤだったレイヤの 、 onTran 
sitionCompleted イベントのイベント，ハンドラを呼ぶ 

③ KAG は、 「 onTransitionCompleted 」 イベント•ハンドラの中で、裏画面だ 
ったレイヤの情報を、表画面だったレイヤの情報にコピーする 

(これにより表画面と裏画面が同じ状態になる） 

④ KAG は、裏画面と面画面の管理情報を入れ替える 


最初にも「表背景レイヤとその子レイヤたち、それと裏背景レイヤと子レイ 
ヤたちを、そっくりそのまま、入れ替える」とありますが、最後にも「裏画面 
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と面画面の管理情報を入れ替える J とありますね。これは、①のタイミングで 
r 吉里吉里」本体は裏画面と面画面を人れ替えますが、それだけだと「本体は 
入れ替えたと思っているが、 KAG 側は人れ替えたと思ってない」という妙な 
状態になってしまいます。 

いままで裏画面のレイヤ • オブジヱクトを参照していた KAG 内の変数が、吉 
里吉里側がレイヤの構造を入れ替えたため、実は表画面のレイヤ • オブジェク 
卜を参照するようになってしまった、という状態を避けるために、つまり、「吉 
里吉里」本体のもっているレイヤ構造の状態と合わせるために、④のタイミン 
グで KAG 側でも処理が必要なのです。 

プラグインでレイヤを表示管理する埸合もこのルールに従う必耍があります。 
プラグイン側にはこのために2つの関数 . 「 onCopy Layer 」 と F onExchange - 
ForeBackJ が提供されています^ | onCopy Layer J は3番のタイミングで、 
「 onExchangeForeBack 」 は4番のタイミングで呼ばれる関数です： 

「 onCopyLayer 」 は forelay タグや backlay タグでも呼ばれる関数ですが、卜 
ランジションの終了時にも呼ばれる関数です。トランジションの終 f 時におい 
てこの関数では、裏両面だったレイヤの情報を表_面だったレイヤの方にコピ 
一しなければなりません:これは 「 onExchangeForeBack 」 よりも先:に呼ばれ 
るので、注意が必要です， 

つまり、 「 onExchangeForeBackJ で表画向と裏画面の矜理情報を入れ替え 
るのですが、それよりも前に呼 ( f れるということは、 r 吉里吉里本体のもって 
いるレイヤ構造の情報と、 KAG あるいはプラグインのもっているレイヤ構造の 
状態が食い違っている状態」で呼ばれるということです。混乱を招くかもしれ 
ませんが、通常は、「雪プラグイン」で行なっているように、綷通に状態のコ 
ピーを行なえば問題ありません。 

ronExchangeForeBackJ では表_面と裏画面のレイヤの管理情報を入れ 
替えなければなりません。これは、今まで裏画面のレイヤを参照していた変数 
.を表画面のものに、表画面のレイヤを参照していた変数を裏画面のものにそれ 
ぞれ入れ替えなければならないと言うことです。 

このように「吉里吉里/ KAG 」 のトランジションの動作はかなりややこしい 
ものですが、「雪プラグイン」などを参考にしてみてください。 
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プラグインを作るといっても、すべてを何もない状態から書き上げるのは大 
変です。最初はプラグインの改造から入るのが適切ではないかと思います。 

ここではその最初の手引きとして、「雪プラグイン」を改造して「泡プラグ 
イン」を作ってみようと思います。 

雪は上から降るものですが、泡は下からわき上がってくるものなので、スク 
リプトの手直しがいくつか必要になります。 


名前の変更 


「泡プラグイン」を作るにあたって、いちばん動作がている「雪プラグイ 
ン」を改造するわけですが、「雪プラグイン」と同時に使いたい場合のことを 
考えて、名前の衝突が起こらないようにしなければなりません。 

まず、「雪プラグイン」のシナリオ•ファイルである 「 snow . ks 」 をコピーし 
ます。「泡プラグイン」なのでファイル名を 「 bubble . ks 」 にしましょう。 

bubble . ks 内にはいくつも 「 snow 」 や「雪」などの名前が使われています 
が、これを 「 bubble 」 や「泡」に変換してしまいましょう。お使いのエディタ 
の「置き換え」機能で以下の名前を一括して変換します。 TJS はアルファべッ 
卜の大文字と小文字を厳しく区別することに注意してください。「置き換え」を 
行なうときは、大文字と小文字を区別するような動作をさせる必要があります。 


爲鼉爾 

_孽後 

雪 

泡 

snow 

bubble 

Snow 

Bubble 


このままだと「泡をふらせるプラグイン」のような妙な表現がコメント内に 
出てきてしまいます。気になる方は書き換えてください。 


03 

# _蠡 
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下から出現するように 




下から出現させるための変更が必要です。 


* 筆者注 

「吉里吉里」の座標系は、 
数学等で用いられてい 
る座標系と異なり、通 
常左上を原点とした、 
右方向および下方向が 
正方向の座標系です。 

氺声者注 

実際には表画面の粒 
も裏画面の粒も同じ大き 
さなので r - fore.heightJ 
は 「- back.heightj でも 
問題ありません。 


まず、泡を出現させている場所を見てみましよう。 BubbleGrain クラスのメ 
ンバ関数である 「 spawn 」 です。 
function spawn () 

{ 

//出現 

1= Math.random() * window.primaryLayer.width; 

// 横初期位置 

t = -fore.height; // 縦初期位置 
spawned = true ； 
fore.setPos(1,t )； 

back. setPos (1,t) ； / / 裏画面の位置も同じに 
fore.visible = owner.foreVisible ； 
back.visible = owner.backVisifole; 

} 

ここの「//縦初期位置」というコメントの付いている行に注目してくださ 
い。変数 fore は表画面の泡粒のレイヤ•オブジェクトを参照しています。同 
様に変数 back は裏画面のものです。変数 t は粒のレイヤの y 座標(垂直方向座 
標）における上端位置を表わす変数ですが、「雪プラグイン」の場合は卜 
fore . height 」、 つまり表画面の雪粒のレイヤ • オブジヱクトの高さを負にした 
ものを代入しています。これにより、初期位置は完全に画面外でありながら、 
画面のすぐ上となっていたのです。つまり、画面外からすぐに画面内に入って 
こられる位置にしているということですね（横位置はランダムになります)。 
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雪粒の出現位置 


泡の場合は下からわき上がるのですから、ここを変更しなければなりませ 
ん。画面外であり、すぐに画面内に入ってこられる位置というと、画面のすぐ 
下になります。 

上端位置が画面の縦幅と同じであればそのような状態になるはずですから、 

，，七 

を、 

t = window. pnmaryLayer . height ； / /縦初期位置 
にします。 rwindow . primaryLayerJ はウィンドウのプライマリ♦レイヤ、つま 
り KAG の場合は背景レイヤですので、その 「 height 」 （縦幅）プロパティはす 
なわち画面の縦幅になります。 

背最レイヤの上雄 

window.primaryLayer.hei9ht (yff«=window.prymaryi.ayer.height) 



泡粒の出現位思 
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上に向かうよう 


移動方向を上方向にしなければなりません。 


BubbleGrain クラスのコンストラクタ （BubbleGrain メンバ関数）で 「 yvelo 」 
という、 y 方向(垂直方向）の速度を決定している部分があります。以下の部分 
です。 


yvelo = n*0. 6 + 1.9 + Math.random() * 0 . 2 ;//縦方向速度 


これの符号をまるっきり逆にしましよう。以下のようになります。 


yvelo = — (n*0 • 6 + 1.9+ Math. random() *0.2); // ife 方向达度 


■ 画面外に出た場合の処理 


雪粒の場合は、雪粒が画面の下を超えれば、雪粒を上の位置に戻して再び 
降らせていました。その動作を行なっている箇所は BubbleGrain クラスのメン 
バ関数である move 内にあります。 


if(t >二 window.primaryLayer.height) 

{ 

t = -fore.height ； 

1 = Math - random() * window.primaryLayer.width ； 

} ___ 

ここの部分です。この if 文の条件式は、「雪プラグイン」では以下のように 

なっています。 


t >= window.primaryLayer.height 


変数 「 t 」、 すなわち粒のレイヤの上端位置を表わす変数の値が、 「 window . pri - 
maryLayer . heightJ つまり画面の縦幅を超えたら、という意味になります。 

泡の場合は、画面の上端を超えたら、という意味にしなければならないの 
で、条件式は以下のようにしなければなりません。 
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# # # # 

t <= -fore.height 


すぐに思いつくのは 「t く 0」だと思いますが、上端位置が「0」、つまり画面 
最上部よりも上になっただけではレイヤ全体が画面外に出たことにならないの 
で 、 「t <= - fore.heightj となります。 

if 文のブロックの中で変数 「 t 」 に値を代入していますが、これは前述した閨 
数 「 spawn 」 内と同じにする必要があります。 


この if 文は、最終的には以下のようになります。 


iT(t <= -fore .height) 

{ 

t = window.primaryLayer.height; 

丄 =Math.random() * window.primaryLayer.width ； 


泡粒の画像 


「雪プラグイン」で使う「雪粒」の画像は以下の5つです。_ 

「 snow_0.png 」 isnow— 1 .png 」 「 snow 一 2•png 」 「 snow_3.png 」 
「 snow_4. png 」 


これと同じように、泡の画像として以下の 5 つを作ります。 

「 bubble_0.png 」 「 bubble_l.png 」 Ibubble—2•png 」 
fbubble_3.png 」 「 bubble_4.png 」 ibubble_5.png 」 


完成 


これで改造は終わりです。マクロは 「 bubbleinit 」 と 「 bubbleuninit 」 と 
rbubbleoptj の3つが定義されますが、使い方は「雪プラグイン」と同じで 
す。 


回 

參參鬱 
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FAQ 



ツ セージ • レイヤー/文字関連 


@ メッセージ • レイヤーに文字を数段に渡って表示したら、縦列がきれいに揃わない。| 

叫咖リ抑抑”リぜ你•ル抑が.•甘.•••り •••《 •撕丄レ抑 

AJ デフォルトにプロポーショナル•フォントを使うと勝手に字詰めが行なわれ、結果丨 
として縦列が崩れます。 Config.tjs 内のデフォルト • フォント指定を「プロポーシ| 
ョナル」から「等幅」フォントに変更してください。 1 


隊裏議靈， さ; ^ 

U メッセージ•レイヤーのサイズをシナリオ内で恣意的に変えるには [position】 タグを用います。| 


•AVG 風表示の例_ 

[position left=40 top=400 width=540 height=60]¥ 


•ノベル風表示の例_ 

[position left=40 top=40 width=540 height=400]¥ 


參全画面表示 

[position left=0 top=0 width=640 height=480]¥ 


@ メッセージ • レイヤーに文字を書いたあと、トランジシヨンで背景画像を切り替え1 
たと;：ろ、すでに害いた文字が消えてしまう。背螢だけ入れ替えて、文字はそのま 
1ま繽けて#きたい。 _ | 

S トランジシヨンを行なう前に [backlay] タグを入れれば、すでに書いた文字が裏画| 
面にコピーされ、それをトランジシヨンで表画面に呼び出すことができます。ちな| 
みに、 [backlay] タグを効果的に利用するには、レイヤーとページの概念を充分に| 
理解することが必要になります。 I 


P ^* r G 3 J 0 脚 32 互換モード』で、文末に[时を付けたのに改ぺ^] 

['ンシしてぐれな:い。塵… ： :ぺ: ' j 

SI[p] タグは改ページの「クリック待ち」を行なうだけで、「改ページ」までは行ない| 
ません。 [p] タグの次に [cm] [er] [ct] のいずれかのメッセージ.レイヤー消去タグ i 
を置けば、すでに書かれた文字がクリアされます。 i 
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####### 


(p メッセ _ジ*レイヤーに文字を表攀させたところ、文末に改ページマークが出てし' 
まう。互換モードではタグ行末に¥を付けると改ページマークが出なくなつたが、 
KAG 3 モードでは [ positionj タグを使う以外に何か方法はないだろうか？ 

[ style ] タグの autoretum 属性を「 false 」 にすれば改行されなくなります。 

® 選択肢のあるシナリオを害いてから画面をトランジシヨンさせたとき、元の画面の 
選択肢が見えないのに選べてしまう0__ . ___ 

® [ locklink ] タグを使って選択肢を「選択不可」にすれば回避できます。 ！ 

フヤーなどに Payopfl タグを使-したら「バ^ 
しアント疲套麵でぎません土といぅ賴一が^^ 

この エラーは [image】 タグにおいて 「layerj や 「 page 」 属性が指定されていない場丨 
| 合や、属性が指定されていても書き方が間違っている場合に表示されます。また、| 

操作するレイヤーが存在して いない ことも考えられます。この場合、 [ laycount ] 夕| 
グで指定のレイヤーを生成すれば回避できます。 | 


自分で作った作品の画面が妙に晴い1」 

(kl メッセージ.レイヤーがデフオルトの状態になっていることが考えられます。 con -1 
%. tjs 内のメッセージ • レイヤーの色と不透明度を変更するか、 [ position ] タグを| 
I 使ってください。 I 


// ♦ メッセージレイヤの色と不透明度 

// frameColor には OxRRGGBB 形式で （RR GG BB はそれぞれ 2 桁の 
//16 進数）メッセージレイヤの色を栺定します。 frameOpacity には 0 
// 〜 255 の数値で、不透明度を指定します。メッセージ枠用の画像が指定 
// されている場合は無効です。 

； frameColor = 0x000000 ； // position タグの color 属性に相当 
; frameOpacity =128; // position タグの opacity 属性に相当 
t ここの frameOpacity を0にする。 

i または、下記の一行をスクリプトの先頭に加える。 

[position layer=message0 page=back rrame="" opacity=0]¥ 
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Config . tjs 内で設定した基本フォントを、途中で rconrfig . tjsj を書き直して変更 
したのに、変更が反映されない。 __ — — 

jtf —度でも「吉里吉里 / K AG 」 を動かした場合、 「 Confittjs 」 内で設定されたフォント; 
は savedata フォルダ内のセーブ.ファイルにシステム変数として記録されているから| 
です。 savedata フオルダ内の全ファイルを削除して再度動作させれば反映されます。| 



3 [ edit ] タグによる単一行エディツトを使います。 


@ 文字を維害きにしか。 


j system フォルダにある 「 Config . tjs 」 の、以下の部分を変更します。 


// ♦ 縦書きモード 

// メッセージレイヤを標準で縦書きモードにする場合は false ではなく 
// true を指定してください。 

； vertical = true ; // position タグの vertical 属性に T 目当 


またはシナリオ • ファイル内に以下のように記述します。 


[position vertical=trueJ ¥ 


メッセージ•レイヤーのサイズを変更し た後、初期 値 にリセッ ト したい。 _ J 

(JJ メッセージ • レイヤーの属性を 「 position 」 で変更した後、初期設定 （ Config . tjs で| 
設定したもの）に戻したい時は、再度 [ position ] タグで指定する必要があります J 
[ リセットするタグはありません。 j 


m ダグを使って選択肢を表示すると、場合によっては空行が出てしまう。 ] 

▲ [if] [link] 〜 [endlink] [r] [endif ]¥ 

上のように記述した場合、改行も条件分岐の中に含まれます。条件が“真”の場合は選択 
| 肢（〜の部分)が表示されて改行され条件が“偽”の場合は改行ごと無視されます。| 
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獵爾靈懸總 


籤# 

###### 


メッ*-ジ履歴を,リアしたい。 ) 

^ rkag . historyLayerxlear 〇 J で初期化できます。 KAG シナリオ内から実行する場合 
は r [ evalexp = n kag . historyLayerxlearO !, ]¥ j の一行を記述すれば、その時点でメッ 
セージ履歴が何も書かれていな V ゝ状態に戻ります。 

また深をたどったときにメッセージ履歴を常にクリアした t 、のであれば、 「 MainWindow .句 s 」 

の 「 function interaalRestoreFlags ( f , clear = true , elm = void )」 の最後(バージョンによっ 
ても若干異なりますが、1283行付近)に fhistoryLayer . clear 〇; J という一行を加えます。| 


珍文字人カダイア p グに人力した文字を、次に人力^ ) 


ダイアログを表示する前に、 [ eval ] タグを用いて以下のように変数に空文字列を入 
れておけば、何も文字が入力されていない状態でダイアログが表示されます。 
「[eval exp = M f . hensuu = 1 ' f, ] | 


@ 終了させたい。 ~~~ 



サリオを終了するときはどんな夕麵 




シナリオ•ファイルで何も書かれていないところまでくれば、「吉里吉里」はそこ 
で自動的に停止します。 [ s ] タグを記述してもそこでシナリオの実行は停止します。 
「吉里吉里」自体を終了したければ [ close 】 タグを使い、最初に戻りたいのであれば 
[ jump ] タグや [ gotostart ] タグを使います。 
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KAG 3 に付属の雪ブラグインを使って画面に雪を降らせ、デバックでシナリオ翳読み 
込みをしたり、開始したラベル以外の今べルからロー ドすると、雪が止まらなくな 
る。また、雪ブラグインをロードしようとするとエラーが出る。 


古い KAG 3 では、雪プラグインを複数回ロードした場合、上記のような現象が起き 
ることがあります。また、 KAG 3 の 「 ver .3.04」 以降では、雪プラグインを2回以 
上ロー ドしようとするとエラーが出るようになりました。雪プラグインや雨プラグ 
イン、スタッフロール•プラグインは 「 firstks 」 の先頭などで一度だけ呼び出すよ 
うにしてください。 


mpeg 拡張子のビデオ • ファイル蠆再生しようとしたらエラーが出て S 生できない、 
また、タグが無視されるのだが？ 


mpeg 形式のビデオファイルを再生する場合はファイルの拡張子まで指定してくだ 
さい。また、 「 krkr . eXe 」 と同じ場所に 「 krmovie . dll 」 をコピーする必要がありま 
す。 


スクリプトを実行中に「二つのレイヤのサイズは同じでなければなりません j とい 


クリツカブル•マップの領域画像ファイル（末尾が Lp 」 のファイル）が上手く 
作れない0 


Photoshop やペインターなどのフルカラー対応ソフトではなく、 rD-PixedJ (フリーソ 
フト）のような256色専用の画像処理ソフトを使ったほうが簡単です。 


クロスフェードなどのトランジシヨンを行なったとき、画面にチラツキが発生して 
しまラ。 


設定ユーティリティである krkrconf . exe を起動して、「画像演算の分割処する/しな 
い」と「垂直同期を待つ」を調整すれば HI 避で^る場合があります。 
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.淡輕辩譯ン潸广ぼ虼切ジ次次:ほ族腿衣。染必 K 鉍 

0画像を表示させようとしたときに P について適切な拡張子を持ったファむレを 
つけられませんでした」のような I ラ-が出る。 ___ ノ 

(8 指定のファイルが存在しないか、または見付からないことが考えられるので、ファ| 
イル名を確認するか、また、ファイル名を「" ”」（半角ダブル•クオーテーシヨン）丨 
[ でくくって指定してください。^ I 


〇 ルール•ファイルを 自作して ユ ニ バーサ ル •トランジシヨンに 使つ たところ、 意図 
したトランジシヨンが行なわれない。__ _ — — 

( aj ルール•ファイルがグレースケールで保存されていない可能性があります。 

トランジシヨンを行なったところ、その少し前にトランジシ孝ンで表示させた 國嫌 
や文字が改めて表示されてしまう。 

圓 トランジションを行なう前に [ backlay ] タグを書き忘れている可能性があります 。I 


^動画が再生されない0 ) 

|i!ll 「 first . ks 」 の先頭行に 「@ loadpluginmodule = krmovie . dll 」 を入れてください。この| 
とき、 krkr . eXe と同じ場所に、 krmovie . dll をコピーする必要があります。この場丨 
| 合、再生する直前に r @ evalexp = , ' WaveSoundBuffer . freeDirectSoundO M J の1行を記| 
1 述すると、不具合が低減されることがあります。_ j 

GT 文字は不透明なままで、自分で作ったメッセージ•ウィンドウを半透明にするに 

..は0 _ — _ _ベ 

® タグで制御するのではなく、メッセージ枠用の画像を半透明の状態で作っておきま I 
す。 a チャンネル付きの PNG をグラフィック•ソフトに出力させるのが手っ取り I 
[ 早いです。 I 


® Flash の swf 利用時に、フラッシュ特有の右クリック•ボップアップ• メニューを j 
禁止したい。_ 


できません。 
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(® そのようなタグはありません。 base レイヤーには黒い画像を読み込み、それ以外の| 
1 レイヤーには不可視状態を指定してトランジションさせれば同時に消えます。 | 


[image storage="kuro. 〕 pg M layer 二 base page=back]¥ 
[layopt layer=messageO page 二 back visible=false]¥ 
[layopt layer=0 page=back visible 二 false]¥ 

[trans method=crossfade time=100]¥ 

[wt]¥ 



ST これは画像処理ソフトの使い方の問題ですが、画像処理ソフトで拡大縮小したと 
きにぴったり 640 X 480 にならない場合は、リサイズを行なって、余分な部分を切 
り落とすしかありません。 



S 何もデータをロー ドしていない前景レイヤーにはダミーとして 32 X 32 の黒い四角が 
表示されます。何か画像をロー ドすれば消えます。_ 


OggVorbis / MP 3/ 音声関連 



5[吉里吉里2ならびに KAG 3 において、 MP 3 は/?版の時点でサポートを打ち切ってい 
^ます。 OggVorbis という代替手段があるので、そちらをご利用ください。_ 



® CD のドライブが re :」 でないことが考えられます。もし CD ドライブに、 「 f :」 や s 
「 q :」 などの別のドライブレターを与えている場合は、スクリプト内の re :」 をその 
ドライブレターに書き換えれば動作します。 
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_ ........——.....___ — ——......_.........__....._....._..........._......_ — — ...— 暴泰籲參癱 

CFwave ファイルの BGM や効果音が途切れ途切れに再生されたり、再生中につつか 
えるような現象が起こるのだが？ 

fej 「吉里吉里2」に同梱されている 「 krkrcontexe 」 あるいは 「 userconiexe 」 を起動 I 
して、 「 DierctSound 」 周りのオプションを変えてみてください。 

OgpVortois にょる BGM や効果音が再生されないのだが？ ) 

指定のプラグインをシナリオ先頭部などでロー ドしているか確認してください。プ| 

ラグインがロー ドされていないと、 OggVorbis 形式のファイルは利用できません。： 


起動/動作/バージョンアップ関連 


吉里吉里」の動作が急に重くなったり、マウスが動かなくなったりする。 _ 

(9 ウイルス活動を常時監視するソフトウヱアの中には、アプリケーションの動作を極 
端に遅くするものもあります。これをはじめ、できるだけ多くの常駐ソフトをタス 
クトレイから外してください。 


fe ， リォを「吉里吉里」で動かしたら、毎回シナリォが一ら 

圔 「 first . ks 」 内で [ jump ] タグを使って別のファイルへ飛べばよいかと。 


GF 作成したゲームを CD - R に焼いて実行すると、終了しようとしたときと菜を挟もう 
とた時にエラーが出るのだが？ CD - R の中身を ハードディスクに コピーして実 
行してもエラーが出るのだが？ 

® CD - R 上から実行すると、吉里吉里が生成したシステム • データを書き込めずにェ 
ラーが出ます。 「 Config . tjs 」 の中身で菜を使わないように指定すれば回避できる場 
合があります。また、 ハードディスクにコピーした だけでは CD - R 上の読み取り属 
性が解除されないので、同様にエラーになります。ファイルの読み取り属性を解除 
するようにしてください。 
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碑露纖猢娜靡 


紹介 用プロジェクト_を起動し 段す ると、 ェラーが 出 


1「吉里吉里」の紹介用プロジヱクト 「 syokai 」 は、 KAG の template フォルダにある 
システムや 「 KAG 3 plugin 」 にあるスクリプトなどを使うようになっているため、 
KAG のフォルダ構成を変更した場合は動作しません。 KAG 3 の圧縮ファイルを展 
開した直後に見られるフォルダ構造を維持していれば、動作します。 





ff 吉里吉里/ KAG でプロジェクトを起動する時に指定するのはプロジェクト • フォル1 
ダであって、個々のシナリオ•ファイルではありません。フォルダを指定してください 。I 



® アップデートに失敗している可能性があります。 KAG のアップデートをする場合| 
は、基本的には、新しい KAG の system フォルダの中身を、既存の system フォル 
ダに上書きするだけで 0 K です。また、 「 krkr . eXe 」 も忘れずに上書きを。 



m 

first . ks の冒頭などに拡張子まで含めて記述します。 

i 

— 

[mappront storage =" font . tft "]¥ 


@起動時にフルスクリーノにしたい。 _ ___J 

S1 手っ取り早い方法は、フルスクリーンの状態の時に終了させ、そのときの 
rdatasc.kdtj (「 datasc . ksd 」 の名前かも知れません）をセーブ • データとして一緒 
に配布します。 「 datasc * kdt 」 や 「 datasc . ksd 」 には、前回フルスクリーンだったか 
I どうかの情報などが書き込まれています。 | 


ゆ画面がウンともスンとも言わなくなってしまう。フリーズしたわけではないのだが。1 

Ml SHIFT キーと F 4 キーを同時に押してコンソールを表示させてください。コンソールの最 
下部のメッセージを読むと、「非表示になっているメッセージ•レイヤーの裏ページなど 
でクリック待ちになっている」場合があります。これはトランジシヨンのミスなど 
でよく発生します。コンソールに書かれたメッセージに従って対処してください。 
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P 蜜や雨ブラグインが利用できない。一 ____ 

( ki 雪/雨プラグインのシナリオ • ファイルと画像ファイルを自分のプロジェクト•フ| 

オルダにコピーし忘れている可能性があります。 i 


ロード時に確認ダイア n グを表示させたくないのだが？ 


a 


[link exp= 11 kag. restoreBookMark ( 0 , false) 11 ] [emb exp="kag. 1 

getBookMarkPageName(0)"][endlink] 


と書きます。 「 restoreBookMark 」 と 「 storeBookMark 」 は第二引数でダイアログ | 
を出すかどうか判断しますが、これらはデフォルト設定では 「 true 」 になっています。 丨 


P 実行ファイルの容量を滅らしたい。 ] 

¢1画像データの場合、画質を落としてもかまわないならば、 「 PNG 」「 TLG 」「 ERI 」| 
ではなく JPEG を使うとサイズを軽減できます。音声の場合は、無圧縮 wav を使う| 
よりは fOggVorbisJ などを使うとサイズを軽減できる場合があります。また、| 
Releaser で出力する実行 （ exe 形式）ファイルは zip と同じ圧縮方法を使っている丨 
ため、 zip 程度の圧縮しかかけることができません。もっと圧縮をかけたい場合は、丨 
Releaser の設定で「圧縮」に分類されているファイルはすべて「無圧縮」に分類: 
し、配布するときに cab など圧縮率の高いアーカイバで圧縮し直すとよいでしょ丨 
う。 UPX よりも cab のほうが圧縮率が高いです。 I 


その他/素朴な疑問 


0 シナリオ.ファイルは大きすぎると処理的に辛いと明くが、一つのシナリオ•ファ~] 
r 儀細サィズ隐くらぃか。 _ I 

fej —つのシナリオ • ファイルが 200 KB を超えるようなら、分けたほうがよいでしょ| 
う。ちなみに、処理的に辛いと言ってもそう問題になるほどではないので、あまり| 
気にする必要はありません。最近のバージョンではむしろ他のシナリオ•ファイル| 
にジャンプするときに時間がかかる場合があります。とは言っても、こちらもそう j 
問題になるほどではありません。 I 


P 「吉里吉里」はノベルゲームやアドベンチャー • ゲームに特イヒしたエンジンなのか。 

( B 違います。ノベルゲームに特化しているのは、「吉里吉里」ではなくて 「 KAG 」 の| 
ほうです。 r 吉里吉里」はアプリケーションやゲームのエンジンで、それをノベル； 
やアドベンチャー•ゲームの専用エンジンとして動作させるのが、 「 KAG 」 です。 
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画像の一部を消去する 


何かの画像を読み込んだレイヤーに対し、矩形で指定した任意の部分の画 
像を消去（透明処理）できますが、 TJS でレイヤーに直接描画する必要があり 
ます。 「 face = dfBoth 」 にして、 Layer クラスのメンバ関数である 「 colorRect 」 
の不透明度の引数に負の数を指定すると、対象の矩形領域から不透明度が取 
り除かれます。この場合は色の引数は無視されます。 


ツプで力_ソルのロール • オーバー時に画像を変える 


領域アクション定義ファイルで ronenterJ を使うとよいと思います。 

1 ： onenter="kag.fore.layers[0]•loadlmages( % [storage:'mapl.png '])"； 
「領域1」にカーソルが来たとき、表画面の「前景レイヤー0」に 「 mapl . png 」 
を読み込んでいます。ちなみに [ button ] タグで対応できるような内容であれば、 


button タグを使ったほうが楽です。画像ファイルに 「 map . png 」 を用意し、そ 
れとは別に、変えたい画像ファイルを 「 mapl . png 」 などで用意します。 


•シナリオ例 

*start 

@ layopt layer=0 page 二 fore visible=true 
; t 前景レイヤー 0 を表示 

@ layopt layer=message0 page=fore visible 二 false 
; T 邪魔なので消去 

@image layer=base page 二 fore visible=true storage=map 

@s 

*ml 

@layopt layer=message0 page=fore visible=true 
領域 1 をクリック 
@s 

@layopt layer=messageO page=fore visible 二 true 
領域 2 をクリック 
@s 
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fmap . maj の内容は以下のようになります 0 


1 


2 

nenter="kag.fore.layers[0],loadlmages(%[storage ： 'map2.png'])"; 
stoage= M first.ks"; target= M *m2"; 


前景立ち絵の“口ぱく”を効率よく行ないたい 


「セリフをしゃべりはじめた」ときにアニメーション • ファイルの付属して 
いる画像を [ image 】 タグでロードし、「セリフをしゃべり終わった」ときにアニ 
メーションしていない静止画像をロー ドすれば、効率的です。 


レイヤー上に簡単な回形を書きたい 


TJS 2 を用いれば可能ですが、実用的な速度は出ません Q 
I @eval exp="kag.fore.base.colorRect(10, 20, 100 r 100 r 

|_0xff0000, 128) " __ 

上の記述の意味は「表背景レイヤの （10,20)- (109, 119) を赤、不透明度50% 
で塗りつぶす」になります。吉里吉里本体に矩形と点や変形以外の描画を行 
なう機能を追加する予定は今のところありません。 


I 画像の階調変更 


階調の反転は image タグの| rceil 」「 gceil 」「 bceil 」 にそれぞれ「0」を、 
f rfloor J r ^ floorj 「 bfloor 」 にそれぞれ「255」を指定することによって可能に 
なります。その他，値を調整すればセピア調への変換などもできます。 


r 吉里吉里」の起動画面を黒から白にする 


というファイルの末/^にある 「 KAG . process ( M first . ks ，’):」 と 
いう部分を「 KAG . process ( M first . ks M ，,， true );」 に書き換えてください。 

また、 Config . tjs 内の下記の部分を 「 ;initialMessageLayerVisible = false ;」 と 
します。その後、 「 first . ks 」 （最初に実行されるシナリオ.ファイル）の先頭 
行で表背景レイヤーに白 V ゝ画像を読み込むように記述します。 

このとき初期状態ではメッセージ • レイヤーが表示された状態になっている 
ので、「表メッセージ.レイヤー0」も非表示にしたほうがよいでしょう。その 
後、 [ wait ] で少しゥヱイトをとって、確実に画面が表示されるようにします。 
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1 •シナリオ例 _ 

[image stORage="white" page=fORe layer 二 base]¥ 
[layopt layer=messageO page 二 fORe visible=false]¥ 
[wait time=100]¥ 


[ S ] タグのみ停止させる仕様 


未読既読とは無関係に、単に「次の選択肢まで進む」仕様にできます。つ 
まり、 [ s ] タグでのみ停止する仕様ですが、これは以下のようにすれば実現で 
きます0 _ _ 

① 「 Config . tjs 」 の 「 autoRecordPageShowing 」 を 「 false 」 に設定。 

② さらに [ wb ] タグの属性を 「 canskip = true 」 にする。 


■買い物画面での買い物制限 


買 t ゝ物などの画面で持ち金が足りなくなるとリンクを無効にし、品物を買え 
なくするようなシナリオは、下記のように記述します。 

•シナ U 才例 

，•変数を初期化 

[eval exp="f.a=0 , f.b=0,f.money=2000"] 

，•代金を決める 

[eval exp=” f • ia=80, f . ib=1000 ] 

★loop 

[er] 

[nowait] 

卵 [emb exp=f .a] 個/ [emb exp=f.ia] 円 

[if exp= f, f . money [if exp=" f . money>=f . ia"][link 

target=*plusa] 購入 [endlink] [endif ] [r] 

エプロン [emb exp=f .b] 個/ [emb exp=f.ib] 円 

[if exp= M f.money [if exp="f.money> = f.lb"][link 

target=*plusb] 購入 [endlink] [endif] [r] 

残金 [emb exp=f .money ] 円 
[endnowait] 

[s] 

★plusa 
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[eval exp="f.a=f.a+ 1"] 

[eval exp="f.money= f.money-f.ia"] 
[jump target=*loop] 

*plusb 

[eval exp="f .b=f .b+1•’] 

[eval exp="f.money= f.money-f•ib"] 
[jump target=*loop] 


■入力文字の制限 


単一行エディット （ EditLayer . tjs ) に「ひらがな」と「•」と「一」のみ入 
力させ、それ以外の文字が入力されたら弾く場合は、文字コードをチヱックし 
て下記のように書くことができます。272 行目 （関数 「 onKeyPress 」） の、 
if(#key >= 32) _ 


となっているのを、以下のように書き換えます。 


if(key > 

='¥x3040 1 && key <= 

'¥x309f * || key == 

• • i 

II 

key == _• 

一 ， ） 





リンクや選択肢への自動フォーカス 


複数の選択肢を表示させ、指定した選択肢に自動的にカーソルをフォーカ 
スすることができます。選択肢を表示した直後に 「@ eva 】 exp =" kag . fore . base . 
cursorX = 40, kag . fore . base.cursorY = 40, kag . current . keyLink =0 M J と書き、選 
択肢のある場所までカーソルを移動させ、 kag . current . keyLink = の部分でリン 
ク番号を指定します。 

ちなみに、リンク番号は1番目のリンクが「0」、次からは「1」「2」「3」と 
なります D 


リンクゃ選択肢用矩形の調節 


リンクを選択したときに出る半透明の矩形の長さを調節するには、 [ link ] と 
[ endlink ] の間に [ locate 】 タグを使います。 


•シナリオ例 

Lstyle autoreturn=false] 

[link] ほけ'ら [ locate x=0] [locate x=580 ] [endlink] [r] 
[link] ほげらラね [locate x=0] [locate x=580] [endlink] [r] 
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[link] ほけらつねら [locate x=0] [locate x=580] [endlink] [r] 
[style autoreturn=true] 

[locate] タグのあとの半角スペースをそれぞれ忘れないように。 


■選択肢のランダム表示 


あめだまを 

A . 綾里姉にあげる 

B . 吉里ちゃんにあげる 

C . Dee りやんにめける _ 

というのを、選択肢のアルファベットの部分はそのままで、選択内容だけを毎 
回ランダムに入れ替えて表示させたい場合、以下のように2次元配列や「入 
れ替え」演算子を使うとスマートに書けます。 


•シナリオ例__ 

^ @eval exp= H f.data = [[• 綾里姉にあげる • ， 1 ジャンプ先ファイル名， ks ，， 

! '★ ジャンプ先ラベル A* し [ f 吉里ちゃんにあげる，，•ジャンプ先ファイル 
名 . ks 1 , ， ★ ジャンプ先ラベル B 1 ] , [ 'Dee ちゃんにあげる，，，ジャンプ先フ 

ァイル名 .ks • , ' * ジャンプ先ラベル C ']]" 

@eval exp= ■’f. tmp = intrANDom(0,2), f.data[0] f.data[f. tmp]" 

@eval exp="f.tmp = intrANDom(0,2), f.data[1] f.data[f•tmp]" 

@eval exp="f.tmp = intrANDom(0,2), f.data[2] f.data[f.tmp]" 

stORage="[0][1]"][emb 

stORage= _’ [1][1]"][emb 

stORage="[2][1]"][emb 

1 行目で、「選択肢として表示する文字列」、「ジャンプ先のシナリオ•ファ 
イル」、そして「ジャンプ先ラベル」を定義しています。中央の3行で、1行目 
で定義した内容を乱数を使ってシャッフルしています。単純に個々の乱数から 
結果を得るわけではないので、重複はありません。最後の3行で、シャッフル 
された内容を選択肢として表示します。 


A . [link targe t= " [0] [2] 

exp="f.data 10] [0]"] [endlink] 

B . [link target="[1][2] 

exp="f.data[1][0]"][endlink] 

C . [link target="[2][2] 

exp=" f.data [2 ] [0] _’ ] [endlink] 
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■ BGM のランダム再生 


前述の TIPS 「選択肢のランダム表示」を応用し、選択肢を表示する代わり 
に PLAYBGM を実行するように指定すれば可能です。 


•シナリオ例 


@eval exp="f.myBGM 

= ['bgml.mid 1 , 'bgm2.mid', 

'bgm3•mid , ]" 



§eval exp 二 , ’ f.tmp = 

f.myBGM t f.tmp] M 

intrandom(0,2), 

f . myBGM [ 0 ] <-> 

©eval exp="f.tmp = 

f.myBGM[f.tmp] n 

intrandom(0,2), 

f.myBGM[1]<-> 

@eval exp= n f.tmp = 

f .myBGM[ f . tmp” 

intrandom(0,2), 

f.myBGM[2] <-> 


リンクのツ_ル* 



「[linkhint』&， 1行目 ¥n 2行目"，]ヒントヒント [endlink】」 のように、 「hint 二」 
に続けて卩淡リと「”，」で囲んでヒントを書くことができます。途中で 「¥n」 
を記述すると、そこで改行させることができます。 


一度入力した名前をそのまま使う 


2回目以降のプレイ、または一度名前を入力した場合に、最初に定義され 
ているサンプル文字をプレイヤーが入力した名前に入れ替えることができます。 
名前を格納する変数を、ゲーム変数" f.name" ではなく、システム変数" sf.name” 
にすれば可能です。 


■ラベル名を乱数か5生成する 


以下のように記述します。 

[eval exp= H f.ikisaki= 1 * number' +mtrandom(l f 3) ” ] 

イコールの右側では乱数によって得られた1から3の数字と 「*number」 と 
いうラベル名（文字列扱い）を結合し、それぞれ 「*numberl」「*number2」 
「*number3」 というラベル名を生成しています。 

それを 「f,ikisaki」 という変数に代入しているので、 r[jumptarget= n &f.ikisa- 
ki”】¥」 と書けば、 「f.ikisaki」 という変数内のラベル名が「&」によって [jump] 
タグの target 属性に引き継がれます。 














当然、 「*numberl」「*number2」「*number3」 という ラベルが シナリオ内 
に存在しなければなりません。 


■ラベル名を変数で指定する 


乱数だけでなぐ一般の変数も、同じようにラベル名に利用することができます。 

•シナ U 才例 

[input name=r.name] ¥ 

[eval exp 二 " f•ikisaki=’ * 1 +f.name"] 

[jump target="&f•ikisaki"]¥ 

*minako 

[e.r]¥ 

みなこ [s] 

*emi 

[er]¥ 

えみ [s] 

*ai 

[er]¥ 

あい [si_ _ _ 

ただし、この例だと、準備されていない文字を入力された場合に飛び先のラ 
ベルが存在しないため、エラーになります。 


[ move ] タグの path 属性に変数を用いる 


「path」 は、「カンマ」「空白」「(と)」のいずれかで区切られた数値の列を 
受け付けるので、 


@eval 

exp 二 "f.x 

=400, f.y=400. 

f.o=255 H 

@move 

layer=0 

spline=false 

page=fore delay=0 time=1000 

path= ’ 

，Scf .x+，，. 

+f.y+ _,•+f.o" 



などのように、カンマで区切った変数を渡せます。 


オリジナルマクロのパラメータを変数に代入する 


mp を用います 。「 Imacro name=piyo] [eval exp= n f.test=mp.para”】 [end- 
macro ]¥j と定義し、シナリオ内で [piyo para=une] と書けば f une f という値が 
f.test に入ります。 








■0 詰め/空白詰め 


「 [emb exp= ,r? %.2f.sprintf(f.tmp) M ]¥j のように記述します。 「％.2f」 は小数点以 
下 2 桁まで表示するという意味です。同様に、 



(2 桁に満たない場合は上位を空白詰め） 

H %3 d « 

(3 桁に満たない場合は上位を空白詰め） 


(3 桁に満たない場合は上位を0詰め） 


のように書くことができます。 


■入力文字列を数値として判定 


文字列を数値に変換するには「+」か 「str2num」 を使います。 「f.number 二 
+f.numberj あるいは 「f.number = str2num(f.number)」 のように記述します。 
「+」は半角しか受け付けませんが、 「str2num」 は入力された文字が全角でも 
強制的に数値へ変換します。 


■変数内容を含むセーブ • タイトル 


「sf.name2」 が登場人物の名前だとすると、 「*labell&f.name2+ f の提案リの 
ように記述すれば、ラベルのセーブ•タイトルに変数の内容が代入されます。 


■変数内容の距離 


プレイヤーが入力した変数を r f.nmlJ とし、乱数によって得られた変数を 
f.nfl 〜 f.nf3 としたとき、もっとも 「f.nml」 に近い変数を f.nfl 〜 f.nf3 の中か 
ら選ぶには、次のようにシナリオに記述します。 

籲シナ U 才例 

[eval exp 二 ,, f • ncll=Math.abs (f. 11 ml-f • nf 1 〉 ” ]¥ 

[eval exp 二 " f•ncl2=Math.abs(f.nml-f.nf2)"]¥ 

[eval exp=”f.ncl3=Math.abs(f.nml-f.nf3)"]¥ 

[eval exp 二 ， , f .nmin=Math.min ( f .ncll,f .ncl2 ) ”] ¥ 

[eval exp=" f . nmin=Math.min (f .ncl3 , f . nmin) M ] ¥ 

[if exp= H f.nmin==f.ncll"]n f 1[endif]¥ 

[if exp= u f.mnin==f.ncl2"] n f 2 [endif]¥ 

[if exp= H f.nmin==f.ncl3"] n f 3 [endif]¥ 
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■最初に起動された日から経過日数を求める 


シナリオの先頭などで「 [eval exp= M sf.firstTime = (new DateO).getTimeO if 
sf.firstTime === void ?, ]¥j と書いておけば、システム変数の 「firstTime」 に初 
回起動時の日付と時刻が入ります。時間原点を「1970年1/1の午前0:00:00」 
とし、それからの経過ミリ秒を表わしているので、現在との差を取ることで時 
間差を計算します。 「(newDateO).getTimeO」 の部分で現在の時間原点から 
の経過ミリ秒を得ています。 


[eval exp="t.passedTime = (new Date()) .getTime() - 
sf.firstTime"]¥ 

[eval exp="f.passedDates = f.passedTime / 

(60*60*24*1000)) "]¥ 

初回 起動から」 emb exp=" f .passedDates "]— 日 ¥_ 


上記の 3 行を記述することにより、初回起動時からの経過日数を求めること 
ができます。 


wait した時間を変数に代入する 


wait に入る直前に、変数に 「System.getTickCountO」 で得られる値を代入 
します。 

そのあと、リンクで飛んだ先でもう一度 「System.getTickCountO」 で値を 
得、その値から先ほどの値を減算すると二つの地点間の通過時間を得ること 
ができます。 


•シナリオ例 

[link target=*s2] リンク [endlink] 

[eval exp="f.start = System.getTickCount()"]¥ 

[wait time=5000]¥ 

[s] 

*s2 

[eval exp="f.elapsed = System.getTickCount() - f.start"]¥ 
； この時点で f.elapsed に通過時間 
[emb exp= H f.elapsed"]¥ 

[s] 
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wait 長を変数で指定したい 


ェンテイテイを利用します。 

參シナリオ例 

*a — 

[eval exp="f.a =1000 " ] [wait time="&f.a"] 

こんにちは 

[ 1 ] 

また、配列を使う方法もあります。 

•シナ 1 J 才例 

[eval exp=’’f.a = [ ] " ] [eval exp=" f .a[l] =10"] 

[eval exp="f,a[2] =1000 "][eval exp="f.a[3] .=10000"] 

[eval exp= n f.b =1"][wait time=，，&f .a[f .b] ” ] 

こんにちは 

[1] _ _ 

こちらの場合は、 [ evalexp =" tb = l lf ] の「1」を「2」や「3」にすることに 
よってウェイトを変えることができます。 


し芯り 

■ 「待ち』のときに菜をいじ5せない 


[waitclick】 タグを使います。このタグが効いている場合は、菜の操作などは 
一切できません。 


:ィト時で処理内容を変更する 


「[ifexp= M kag.chSpeed!=0"] ノーウェイトのとき行なわない処理。 [endif]」 ま 
たは「 [playsestorage= M 再生するファイル" cond="kag.chSpeed!=0"] 」と記述し 
ます。 


「kag.chSpeed」 というのは、文字表示速度です。 


■ ビデオ再生開始時の黒バックを表示しない 


映像の再生開始時に一瞬黒くなる状態を回避するには、再生開始時を見せ 
ないようにします。下記のように再生開始後わずかな時間だけ映像を非表示 
にしておけは H ノ《ックを見えなくできます。 
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參シナ U 才例 __ 

[videoleft=0 top=0 width=640 height=480 visible=false]¥ 
[playvideo storage= M white.avi M ]¥ 

[wait time=100]¥ 

[videoleft=0 top=0 width=640 height=480 visible=true]¥ 


■曲と画像の同期 


[ resetwait ] タグと [ waitmode=untiltime 二?????]を組み合わせて使います。 


•シナリオ例 _ 

[playbgm storage= n xxxxxx" 100 p 二 false]¥ 
[resetwait]¥ 

； なんらかの処理 

[wait mode=until time 二 ？？？？] ¥ 

； t 曲再生開始（正確には resetwait タグの位置）から 
. ???? ミリ秒まで待つ 


■音と文字を同期させ、スキップ中は音声を再生させない 


自動的に読み進む場合に“真”になっている 「kag.autoMode」 を利用します。 

•シナリオ例 

Lplayse storage=voice. wav cona= *' ! kag. skipMode"] 

表示 メッセージです！ 

[ws cond="kag .aut oMode"][1][stopse] 

自動読み進み状態の場合は [ws] タグで待ち、スキップ動作中は音声を再生 
しないように cond 属性を指定しています。 


■動画や音声データを CD から読み込む 


必要最小限の実行ファイルのみをハードディスクにインストールし、それ以外の画 
像や音声データを CD にアクセスして読み込みた t 、場合は、下記のようにします。 

要領は、 「Storages.searchCD」 で返ってきたドライブ文字を、 「Initialize.tjs」 
の 「Storages.addAutoPath」 の指定先に組み込むことです。 「Storages.searchCD」 
は、該当する CD が見付からなかった場合に空文字列を返します。 










•シナリオ例 _ _ 

★checkCD 

@eval exp="f•CDdrive = Storages.searchCD (’ GAME_CD')" 

@if exp="f.CDdrive == 

@cm 

[nowait] CD を ドライ ブに挿入してください • • • [endnowait][1] 

@ jump target= *checkCD 
@endif 

@eval exp="Storages.addAutoPath(f.CDdrive + ' : /data/ 1 )" 
@eval exp="Storages.addAutoPath(f.CDdrive + ' :/ data/some. 
xp3 # • ) 

0s__ 

「GAME_CD」 は CD のボリューム • ラベルです。 「Storages.addAutoPath」 
を使っている部分で CD の eg デイレクトリと 「data/some.xp3」 の中に自動検 
索パスを設定しています。自動検索パスを設定しておけば、ファイル名を指定 
すれば自動的に CD の中のファイルを参照するようになります。 


アイルのジャンプ 


TJS スクリプトを変更すれぼ可能です。 「Initialize.tjs」 の rif(Storages.isEx- 
istentStorage(System.exePath + ”patch.xp3 n ))」 と書いてある行の前に、たとえ 


ば以下のように記述します。 


if(Storages. isExis tentStorage(System.exePath + 

"scenario.xp3 H )) 

{ 

Storages.addAutoPath(System.exePath + M scenario.xp3#"); 

} — — _ 

これで「吉里吉里」の実行可能ファイルと同じ場所に 「scenario.xp3」 が存 

在すれば、その中にあるファイルも読みに行くようになります。 
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■配布ファイルを分割する 


たとえば、 I scenario.xp3」 と 「graphicxp3」 を作っている埸合、 

Storages.addAutoPath(System.exePath + "scenario.xp3 #”）； 
Stora ges•addAutoPath(System,exePath + u graphic.xp3 # n )； 
のような行を、 「Initializers」 に「追加」する必要があります a 
場所は 「Initialize.tjs」 のどこでもよいですが、書く位置によってファイルの 
検索順が変わるので、同名のファイルが存 /f するときは注意が必要です。他 
の 「Storages.addAutoPathj よりも後ろに#いたほうが検索で優先されるので、 
ir{Storages. isExis tentStorage(Sys tem.exePath + 

"patch.xp3")) 

という行の直前に追加することをお勧めします。 

必要に応じてこれらは追加してかまいませんが，このような記述だと、各 
xp3 内直下のファイルしか検索されません。 xp3 ファイルは内部でフォルダの 
階層構造をもてるようになっているので、 f scenario,xp3」 や 「graphic,xp3」 
を作るときは、 Releaser で指定するとき、その指定したフォルダ直1てに必要な 
ファイルが存在するようにしなければなりません c 必要ならば、 

Storages . addAutoPath ぐ System. exePath -f 

_ "crraphic .xp3#graphics/ n ) ;___ 

のようにアーカイブ内のその下の階層を指定することもできます M 

また、 「Storages.addAutoPath」 には、 f System .exePath + J が必要になりま 
す。「吉里吉里」の実行可能ファイルと同じ埸所にあるということを明承しな 
いと、トラブルが発生する吋能性があります a 


■複数のパッチを配布する 


初回公開時のファイルを 「verl.Oj として verl.l パッチを作り、公開した後 
に、 verl.2 パッチをリリースしたくなった場合には、 verl.2 パッチの内容に 
verl.l の変更点を包有しないでも verl.l から 1.2 への差分ファイルだけの配布が 
できます。 

KAG3 の場合、 patch.xp3 の次に patch2.xp3 patch3.xp3 patch4.xp3. と探 

していきます。なかった場合は、そこで探すのをやめます。このため、パッチ 
だけを随時追加していくことができます。 
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Warning! ( 注意） 

このページ以降に紹介されている作品は、 KAG 使いを目指して吉里吉里 
2/ KAG 3 を学習される皆さんのために、フリーソフト作者の方や同人サークル 
の人々が「参考までに」と本書への収録を許可してくださったものです。 

中にはソース（シナリオ • ファイル、画像、音など）を全部または一部公 
開している作品もありますが、以下の利用規定に従ってご活用ください。遵 
守されない場合は著作権の侵害となります。 

① 本書に付属す る CD-ROM 内に収録され ている ゲーム • 作品 • 素材に ついて 
は、それぞれの作者または権利者が readme ファイルなどのドキュメントに 
明記して いる 利用規定に従って利用してください。 

② 特に作者の明記がない場合、これらの一部または全部を不特定多数の人間 
が閲覧可能なネットワーク上に無許可でアップロードしてはなりません。 
また、無許可で CD-ROM などのメディアに収録し再配布してはなりません。 

③ 画像、音響素材、映像などの素材をそのまま、または改変して自作品内に 
使用してはなりません。個人的な学習用途に利用する場合のみ自由に利用 
できます。 

④ シナリオ ks ファイルの内容をコピーしてそのまま自作品内に使用してはな 
りません。自作品に合わせて改変し、利用する場合は可です。収録された 
シナリオ ks ファイルの利用はあくまでも参考程度にとどめてください。 

⑤ この CD-ROM 内のデータを利用したことによってユーザーが何かしらの損害 
を蒙った場合、本書の著者、本書の出版社、収録ソフトウェアの作者は何 
らその貴を負わないものとします。この条件に同意できなければデータの利 
用は認めないものとします。 

KAG 使いを目指して後に続く人々のためにも、ルールを守って気持ちよく 
利用されることをお願いいたします。 





付録 


參_春肇_ _ 


CD_ROM の内容について 



▼収録データ • フォルダ 

吉里吉里ダウンロードサイトで公式に配布さ 
れている「吉里吉里2 SDK version 2.18 / KAG3 
version 3.18 revision 2」と、ルール•ファイル 
が30種類以上含まれたトランジション•ライブ 
ラリが収録されています。 

利用規定については同梱のドキュメント•フ 
アイルの内容に従ってください。 


▼ KAG 講座フォルダ 

本書の KAG 講座で説明されている内容を用 
いたサンプル.プロジェクトが収録されていま 
す。これは本書内に掲載されているシナリオ例 
の大半をそのまま吉里吉里で動かせるようにし 
たものなので、本書を読みながら Step ごとにひ 
とつずつ実行してみることをお勧めします。 

なお、本プロジヱクトはいくつかの吉里吉里 
プラグインを利用しています。このため吉里吉里を展開したときに得られる 
「kr2_218r2¥kirikiri2¥plugin」 内に含まれているすべてのプラグインを 


Q 糖データ 
Q 座 

し j plug-in 
b -Q プロジェクトフオルタ形式 
Q 1999xe1999 
C3 Canvas^Life_p 
Cj showercall 
Q ド□ヌマン 
Q 紫月 vol.0 
•Q 桃花扇サン：?ル版 
e-Q 実行形式 
•Cl Collage 
C] Foster 

Lj PictualStory-twer 
白 • ca ガラスの中の少女 
l h : ] scenario 
.Cl ゾ〇ディアツク r120 
scenario 

■ Q 学校七不思議 
•Ca 最後の夏 
•Cl 萝祕わり 
白. -Q 索材 

•Q OggVorbisBQMSE 


「krkr.eXe」 ど同じフォルダ内に配置しないと正常に動作しません。本プロジ 
ヱクトの利用規定については同梱のドキュメント.ファイルの内容に従ってく 
ださい。 


▼plug-in フオルダ 

TJS 編第 16 章で制作演習を行なった「泡のプラグイン」が含まれています。 
細かい利用規定については同梱のドキュメントファイルの内容に従ってください。 

▼ 『プロジェクト•フォルダ形式』フォルダ内の作品について 

6作のゲーム（一部サンプル版）が、作者の方々のご厚意によって公開直 
前の状態で収録されています。ダウンロー ドした吉里吉里を展開すると得られ 
る template フォルダと同じサブフォルダ構造を持っており、これをリリーサー 
で exe にまとめると公開用の実行形式ファイルになるので、リリーサーの使い 
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CD - ROM の内容について 


方を練習するときにも使えるでしょう。また，すべての素材やシナリオが丸見 
えなので、 ks ファイルの中身を読みながら動作を確認していくことによって 
KAG シナリオを書くときの参考になるかもしれませんが、画像や音響素材の 
利用は本書を購入された方の個人的な学習用途に対してのみ可能なので、注 
意してください。 

すべての作品はプロジェクト • フォルダを 「 krkr . eXeJ にドロップすれば純 
粋に ゲーム （一部サンプル版）として遊ぶことができますが、これらの作品の 
ほとんどは特殊な処理を行なう卜▲で KAG 講座と同様に吉里吉里プラグインを 
利用しているため、吉里吉里を展開したときに得られる 「 kr 2_218 r 2¥ kirikiri 2¥ 
plugin 」 内に含まれているすべてのプラグインを 「 krkr . eXe 」 と N じ フォルダ 
内に配置する必要があります。これを行なわずに起動すると正常動作しないの 
で、ご注意ください， 

また、その他の細かい利用規定については，圧縮ファイルを解;東すると*得 
られる readme . txt またはそれに類するドキュメントをご覧ください： 


▼ 『実行形式フォルダ』内の作品について 

「吉里吉里 2/ KAG 3」 で制作された完成版の作品が8本収録されています,， 
-般公開用と同様の圧縮形式（一部インストーラ形式）で収録してあるので、 
それぞれの作品を自分の PC にインストールするか、任意の埸所に展開するな 
どしてお楽しみください D アニメーシ 3 ンや画像の移動、変数処理による謎解 
きやマルチエンデイングなど、「吉里吉里 2/ KAG 3」 を使うとどのような作品 
が制作できるのか、その理解の手助けになると思 I 、ます。. 

なお、一部作品につ t ゝては作者の方のご厚意から ks ファイルのみ公開のお 
許しをいただきました。これらのサブフォルダには scenario フォルダが存在し， 
その中に KAG 3 シナリオの書かれた ks ファイルが E 縮状態で人って I ゝます。画 
像や音などの素 W がな I ゝため実行はできませんが、読むだけでも勉強になるで 
しよう。 


▼ 『素材』フォルダ内のデータについて 

フリー素材として利用できる OggVorbis 形式の BGM をご提供いただきまし 
た。 この 素材 フォルダ 内のデータだけは取り扱いが異なり、皆さんがゲームを 
作る上で使えそうなシーンがあったらどんどん利用してもらって構いません。 
もちろん、作者の方の利用規定をきちんと守ってご利用いただく必要があるの 
で、収録されている readme . txt をご覧ください 0 


#春#⑩_拳# 


拳注 

それぞれの汪縮ファイ 
ルの展開について脱明し 
ます a 

「KAG 講座」 ri999xej 
「ドロヌマン J 「紫月」「桃 
花爾」 「ZODIAC」 の6作 
品は GCA 自己展開害廩形 
式なので、ダブル•クリ 
:/クして展開先を指定す 
れば、そこに圧縮ファイ 
ルの中身が展開されます。 

r Can vast rfej f Foster] 
「 PictualStory-twe 卜」は 
インストーラ形式なので、 
インストーラの指示に從 
つて展開してください。 

fshowercallj 「ガラス 
の中の少女 J 〖学校七不思 
mi [最後の夏. I r 夢の終 
わり」は LZH 形式の圧縮 
ファイルなので、 L2H フ 
ァイルを展開できる圧縮 
解凍ソフトを利用して展 
開してください e 

ブラグインの 
fbubbte.zip」 と rcollageJ 
は ZIP 形式の圧縮ファイ 
ルなので、 ZIP ファイルを 
展開できる圧縮解凍ソフ 
卜を利用して展開してく 
ださい。 
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収録作品紹介 
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ホラー • テキストアドベンチャー ri999ChristmasEve [ver. 1.9990]] 


「横浜かまいたちファンクラブ」 ( YKFC ) 

内にある「 1999 ChristmasEveProjectJ 
2000 年の12月に公開したノベルタイプのテ 
キストアドベンチャーゲームです。 

ホラー系なので怖いものが苦手な方にはお 
勧めできませんが、「当時の KAG でどんなこ 
とができるのかをできるだけ数多く試す」と 
いう目的で、さまざまな表現形態に桃戦し 
た、実験的な作品となっています。 

現在ネット上で公開されて t 、る最新の/くージョンは「1.3」で、これは占里杏里 / KAG 
の旧ノマージョンで制作されたものですが、本書には吉里吉里 2/ KAG 3 に移植した未 
公開の 「 Final /9⑴）1.999」バージョンが収録されています。バグ，フィックス 
は行ないましたが、一部誤動作することがあるかもしれません。爹めご了承く 
ださい。なお、これは公開)?！完成版ではないので、はご遠慮ください。 

演出の見所や KAG シナリオのワンポイント 

それほど大したことはしていないのですが、以 F の機能を使っています:. 

•別ファイルによるマクロの集中管理 
• 制限時間つき選択肢 

• RPGM 戦闘画面の構築 
. 皆楽と文字表示の期 

• OggVorbis による BGM 
，変数を利川した体力の在示とサブルーチン 

•スタ.ソフロールとエンデイングリスト 

•右クリックによる未読/既読利別機能 

「本格的な長編を作りたい」という理由で制作に人ったので、シナリオが長くなる 
ことは覚悟していました & このため、できるだけ読みやすい記述を心掛けました 
が、いかがでしょうか。 KAG 使いを目指す方々のご参考になれば嬉しいです。 

(文： I 横浜かまいたちフアンクラブ j 代表 P 丨 A 少尉） 



http://www.piass.com/ykfc/ 
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l アル • ノベルゲーム 『Canvas Life 前夜祭 DISC 』 


家族と家庭というものは、戦後になってそ 
の関係力错しく変容しつつあります。 

子供は親の所有物という父を家長とする古 
い家族関係の時代とは違い、最近良く耳に 
するのは「虐待」という言葉。子供の自我 
が成り立たない間、その個体が生命を維持 
するには親に依存しなけれぱいけません。し 
かし、親が子供に依存してしまい、行き過ぎ 
た貘や性的搾取に^、たることは珍しくな t 、です。 

「子供って何だ？」「家族って何だ？」そういうところからこのゲームは生 
まれました。尊敬されない父親、母であることを忘れる母親、感謝することを 

忘れた子供 . 今の時代、いろいろな大切なことが豊かさに隠されておざな 

りになってしまっています。大切な忘れ物を届けるために、このゲームは作り 
出されたのです。ライトな感覚でお楽しみください。 



この作品は「吉里吉里2/3 39」の時代に 
作られたものです。初めて吉里吉里で作っ 
た作品なので、かなり稚拙な内容になって 
いますが、「未読判定付きの CG 鑑賞モー 
ド」や「口ード画面」「音楽モード」や「ス 
タッフルーム」など、構造的には一通りを 
網羅しているので、これから作ろうという 
方には参考になると思います。 

収録するに当たって、もともとの成人指定の内容を一般向けに改変し、 
「 ver 2.18」 に対応させています。ソースがめちゃくちゃ汚いのは申し訳ないで 
す。現在までに五本の成人指定 VNG をリリースしてますが、最新のは多少 
きれいなソースです。後は本当にベーシックな演出しかしていません。 

これから死ぬまで吉里吉里でモノを作り続けていくと思います。それだけ吉 
里吉里には魅力があります。このツールは表現することの喜びをもたらしてく 
れました。みなさんにもそれが伝われば、作者冥利に尽きます。 

_(文： 『 ICONOC し ASM 』 主宰京秋人） 

http://www.alpha-net.ne.jp/users2/ryouot/ 
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収録作品紹介 


ヴイジユアル • ノベルゲーム『シャワーコール』 


『現実』という単語を辞書で調 
ベてみましよう。そこには『頭の 
中で考えるだけのことではなく、現 
に実際こうであるという状態•事 
実』と書かれていると思います。 

でも、こんなことを考えたこと 
はありませんか？ 人生など、誰 
かが見ている『長い夢』の一部分 
にすぎないのではな I ゝか…。 

この作品の主人公は、ごく平凡 
な人間です。夢と現実とが交錯する中で、そんな主人公がどのように考え、行 
動するのか。ストーリーが進行するにつれて、微妙に変化する『現実』という 
単語の意味。そうしたものを、楽しんでいただければ幸いです。 

演出の見所や k _| 象# mmvmyh 

演出- KAG シナリオともに、ご 
く平凡な構成になっていると思い 
ます。強いて見所を挙げるとすれ 
ば、土曜日•深夜のシナリオで作 
成した『雷鳴効果』だけかもしれ 
ません。 

ほぼ一年前に作成した KAG シナ 
リオを見てみると、何ともガサツ 
で幼稚なタグを書 tr ゝて V ゝたのだと思 
わず赤面。 

サンプルとして皆様のお役に立つかどうか甚だ疑問ではあるのですが、この 
程度の知識でもノベルを製作できるということをご理解 t ゝただければ本望です。 


( 文 ： 『studio WALKJ 代表朝から炒飯） 
http://members.jcom.home.ne.jp/studio-walk/ 
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ド□ヌマン』 


ベ 


脱力系ブラックお笑いノベル『泥沼ヒー 






人がいるところで「助けて〜」と叫べ 
ば、たいてい誰かが手を差し伸べて助け 
てくれると思います。 

しかし、それで助かるとは限りません。 
事態が悪化するかもしれません。それば 
かりか、助けてほしいわけでもないのに、 
余計なことをしてくれるかもしれません。 
そんな ヒーローが いたとしたら…… 



という感じで製作されたのが、このドロヌマンです。『泥沼ヒーロー』です 
から、もちろん何かすればするほど事態が悪化します。実際にいたとしたら、 
絶対に来てほしくない、ハタ迷惑なヒーローの生き様を見てやってください。 


演出©見所や KAG シナ U 才のワンポイント 



本作はギャグノベル。そのため、「テン 
ポよく」「事態が悪化する」ということを 
念頭に置いてネタを考えました。ある程度 
ネタが揃ったところで、それらを組み合わ 
せて全体の流れを決めます。 

この後に絵を描き始めるのですが、ここ 
で KAG でどのような演出ができるのかを知 
っていれば、具体的にどんな絵を描けばよ 


t 、かイ メー ジ しやすくなります。まずは簡単なものを作ってみることを オスス 
メします。私も初めての練習として、ドロヌマンを作りました。 

さて、全体の流れと見せ方が決まると、こんどはシステムをどうするかが決 


まります。プログラムに慣れている方ならば、いきなりマクロを組んで処理を 


効率化させることもできると は 思いますが、そうでない方はまず マク ロなんて 
考えずにシナリオを書いてみてください。そして少し作ったところで見直して 
みると、似たようなことを複数記述している部分があるでしょう。その部分を 
マクロで 統一すると、スクリプトが見やすく、書くのも簡単になります。です 
から、マクロは ぜひ マスター することをお勧めします（と 言いつつ、 私もさほ 
どマクロ 化できてる わけでは ないのですが 。 A ;) 


あとはやる気と時間さえあれば、きっとあなたにもゲームが作れますよ！ 


( 文：『地球のあくび』 うにゆ〜） 
http://www.earthcape.ne.jp/users/unyu/ 
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女性向けノーマル恋愛アドベンチャー『桃花扇 〜 Sample Version 〜』 


フリーソフトとして配布予定の中華 
風アドベンチャーの体験版プラス a 。 

序盤の一週間がプレイできます。 

プレイヤーの分身となるヒロインは、 

桃花（名前変更可能）おてんぱ娘で口 
の達者な女の子です。 

攻略可能な男性キャラクターは全部 
で七人 。 Sample Version には、そのう 
ち二人が登場します。彼らとの好感度 
を高めていって ベス ト エンディ ングを迎えるのが、 ゲームの 主な目的です。 

体験版にシナリオを若干追加したため、半端なところで話が途切れていま 
す。続きの気になる方は、一度クリアすると出現するパスワードをホームペー 
ジまでお持ちください。 

演出の罵所や KAG シナ U 才 0) ワンポイント 

いちばん苦心したのは 、 RPG 
風の戦闘シーンです （「 daily ¥ 
batol . ks 」。 未完成）メッセー 
ジ • レイヤーを position タグで 
体カゲージとして表示させ、敵 
に攻撃されるごとにゲージが減 
っていく仕組みになっていま 
す。 

朝ごとの日付表示は 「 call — 
return 」 で呼ばれ、月や年が自 

動で進んで V 、きます （ daily ¥ date . ks ¥* date ) 。 

立ち絵表示はマクロ化し、直前に表示された画像と比較して、同じなら卜 
ランジション時間を短縮します ( daily ¥ makuro _ trans . ks ) 〇 
まだまだ KAG の多彩な機能を使いこなせていませんが、皆様の参考になれ 
ば幸いです。 

( 文 ： 『SENA Project 』 グロア） 
http://fairy.vis.ne.jp/project/ 
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ドベンチヤー 『紫 月 』 VoLO (サンプル版） 


「 IssisFactory 」 が「横浜かまいたちフ讀 
ァンクラブ」さんと共同で開発している学 
園ホラー•アドベンチャーです。 

完成はまだ先なのですが、 PIA 少尉殿の 
ご要望に従い、序章の部分の全ソースを 
KAG 3 シナリオも含めて素材の状態で提供 
させていただきました。序章のみのサンプ 
ル版のため、ゲームとして遊ぶには非常に 
短いですが、立ち絵と顔絵を使ったアドベンチャーゲーム風の画面レイアウト 
構築、右クリックによる現在位置表示の他、我々が目指している効率的なマ 
クロ定義によるシナリオ簡略化がご参考になれば嬉しいです。 

分担ですが、 flssisFactoryJ の吉田が原画、彩色、背景 CG などのグラフィ 
ック全般を、そして「横浜かまいたちファンクラブ」さんのスタッフの方々が 
シナリオとサウンド、全体のコーディネイトを手掛けてくださっています。 

( 文： 『 IssisFactory 』 代表絵師 • 吉田神 一） 



http://www.piass.com/issis/ 



漢出©見所や KAG シナ U 才のワンポイント 

アドべ ン チャー ノベル 風の画面レイアウトの 
ため、それぞれの用途に応じた前景レイヤー 
を6枚定義しており、必要に応じて [ laycount ] 
でレイヤー数を調整して使っています。 

また、本作はできるだけ BGM の使用を 
抑え、効果音による臨場感と聴覚刺激に 
よる恐怖を演出する方向で制作しているの 
で、 BGM 、 SE ともに OggVorbis 形式を採 
用しました。特に効果音については W . Dee さんが制作した 「 LoopTuner 」 と 
呼ばれるソフトで生成できる SLI ファイルを利用しています。 

さらに、背景絵、顔絵、立ち絵などは、すべて rissisFactoryJ の吉田神一 
氏にお願いし、ほとんどの立ち絵キャラクターに目バチアニメーションを採 
用、さらに重要なイベント絵については市販のゲーム同様1枚絵を書き下ろし 
てもらっています。 

rissisFactoryJ のポップなキャラと、 YKFC のシリアスなシナリオがマッチ 
するように気をつけながら、鋭意制作中です。 

( 文：『横浜かまいたちフアンクラブ』代表 P I A 少尉） 


http://www.piass.com/ykfc/ 
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スタイリツ 


ーマンドラマノべル 『 Collage 』 


物語というのは一人の人生の一部 
分を垣間見るという行為だと思いま 
すが、脇役にも同様に人生があり物 
語があります。その物語においては 
その脇役が主人公であり同様に脇役 
が存在し、その脇役にもまた人生が 
ぁり- 

そう 考える と一人の人間の人間関 
係というのはきわめて複雑です。そ 
の相関関係や感情の行き来を完全に認識することは不可能でしょう。 

「 Collage 」 の制作は、そのような謎を少しでも解き明かしたいというのが 
動機のひとつとしてあります。もちろんそんなことは不可能ですが ..... .まあ、 

あまり難しいことは考えずに、「こいつとこいつがこうなるのかよ！」みたい 
な感じで楽しんでんゝただければ幸 t 、です。 



....... 具” J 禮織職 

薩 




この作品は move タグを多用 
することによって動きのある画 
面を構成し、プレイヤーを飽き 
させないように工夫したつもり 
です。また音楽や効果音と画像 
のシンクロも意識してたので、 
そちらも楽しんでいただけるの 
ではないかと思っています。 

吉里吉里2は非常に高機能で 
ァドベンチャーゲームを 製作す 
るということで想像されるイメージは、ほぼすベて再現することができます。 
はじめは少々面倒に感じるかもしれませんが、使えば使うほどできることの多 
さに開発が楽しくなると思います。とにかくやってみてください！ 


( 文 ： 『Homegorosi PROJECT 』 コミネト） 





http://www.geocities.co.jp/Bookend-Ryunosuke/3968/ 
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コマンド選択式アドベンチヤー 『 Foster 』 


温泉宿での殺人事件の謎を追 
う、オーソドックスなコマンド選 
択式アドベンチャーゲームです。 

殺人事件が発生した温泉宿で、 

事件の真相を追うために主人公が 
宿での聞き込みを開始します。 

ゲーム中では時間が流れており、 

無駄な捜査をすると事件の真相に 
たどり着くことはできません。 

イラストはネット上でも活躍さ 
れている桜木晶さんにご協力いた 

だきました。どれもすばらしく、これだけでも一見の価値はあると思います。 



_( 文 ： [Red Letter 』 東真哉） 

http://hgashi.tripod.com/redletter/ 

V - _ ノ 



ン fPicturalStory - twei-j 


http://hgashi.tnpod.com/redletter/ 


「 PicturalStory 」 の続編で、画 
家を目指す青年が女の子たちと繰 
り広げる恋愛 (?) 物語が テーマの 恋 
愛シミュレーション ゲームです。 

前作の設定は、修行のためにあ 
る街にやってきた絵描きを目指す 
青年が芸術の発展に力を入れてい 
るその街で、画家としての腕を磨 
きつつ、絵のモデルを探し、恋を 

する-そんな物語でしたが、 

この続編では絵のことなど何も知らな V ゝ青年が前作の舞台である街を訪れ、い 
いろいろな物語を繰り広げます。 ゲームの 目的は前作同様3年の間に女の子と 
親しくなって、絵のモデルになってもらうことです。 


( 文 ： 『Red Letter 』 東真哉 ) 
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組み合わせて推理をするという、やや特殊なシステムを採用しています。問題 
編と解決編にわかれた犯人あて推理小説の、ホラー版といったところです。 

「最後の夏」と同様、「パソコンで読む小説」を意識して作ったものです。 
背景の多くは合成写真ですが、自己主張があまり激しくならないように、かつ 
絵になるように調整しました。音楽も、しっとりと落ち着いていて美しいもの 
をお借りしました。トータルバランスには気を配ったつもりです。 

演出®麵ゃ KAG シナ U ォ肺ンポイント 

、デモシーンなどで音楽と画面のタイ 
ミングをあわせるためには、 [ reset - 
wait] 、 [wait mode = M until n ] を使います。 

ただし、画像を読み込むためのタイ 
ムラグが生じるので 、「 touchlmagesj 
を使って画像をキャッシュに入れてお 
くか、「 assignlmagesj を使って順次 
処理をする必要があります。 

また、作業フォルダで吉里吉里を走 
らせるのと、アーカイブ化した状態とでは、タイミングが変わってきます。 

わたしはこのあたりを（実はこれに限らず全編を）行き当たりばったりで適 
当に作業していました。何回調整したか数え切れません。製作には計画性が 
必要だと痛感しました。 

(文：『林檎坂通信』管理人 SUZUNE ) 
http://www2.odn.ne.jp/suzune/ 

V__ ) 
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ホラー•アドベンチ ヤー ノベル 『 ZODIAC 』 

■ ••• ウナ、 


「ホラー•アドベンチャー」と「ノべ 



ル」。このまったく異なる2つのジャンルを 
融合させた、新しい感覚のゲームです。 

雪に閉ざされた秘境古代都市、ゾウディ 
アックにやってきた主人公は、突然の雪崩 
に巻き込まれて仲間と離れ離れに。仲間を 
捜しながら助けを呼ぶべく歩き回る主人公 
ですが、彼の前に見たこともない怪物や謎 
めいた現象が立ちはだかります。ゾウディアックで何が起こったのか。そして 
主人公は無事に仲間を見付けて帰還できるのか。先の読めないストーリーがあ 
なたを待っています。 

また、 ホラー •アド ベンチャー ゲームには欠かせない謎解きにも力を入れて 
います。プレイヤーはステージ中に散りばめられたヒントを集めながら、謎を 
解いて先に進んでいきます。謎解きの難易度は高めなので、謎解きが得意な 
方、市販のソフトの謎解きが簡単すぎるという方にお薦めします。その他にも 
敵との戦闘、選択肢によって変化するストーリー、 マルチエンディング など、 
プレイヤーを飽きさせないように工夫をしています。ぜひ一度プレイして、こ 
の楽しさを味わってください。 

演出の見所や KAG ジナ U 才0ワンポイント 

本作品では複数の人間がスクリプトを 
担当したので、演出の統一に注意を払い 
ました。 

また、 BGM や背景画像のフヱードア 
ウト/インも、あまりやりすぎるとユーザ 
一にストレスを与えてしまうし、まった 
く意識しないと呆気のな t ゝゲームになっ 
てしまいます。そのバランスは製作者に 
よって違ってくるのでしょうが、演出上非常に重要な部分だと思います。 

本作品では行末クリック待ち（[1])の代わりにウェイトタグを使用していま 
すが、ユーザーの評判はイマイチでした。製作者にとって重要なのは、自分が 
何を作りたいのかと、ユーザーが何を望んでいるのかを常に考えながら製作す 
ることかもしれません。 

(文：『ゾウディアツク』制作指揮陽炎） 

! http://www.zodiac-series.com/ 
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学園ホラー•アドベンチャー『学校七不思議』 


学生なら、誰もが必ず一度は耳 
にする怪談話。七つあると言われ 
るけれど、七つ目はなぜか誰も知 
らない。「なぜ誰も知らないのに七 
不思議？」「七つ目を知ってしまう 
とどうなるのか？」。単に学校の怪 
談話を並べるだけでなく、その謎 
について考えた物語をゲームにし 
てみました。 

忽然と消えた二人の女生徒。彼 
女たちが、?肖えたのも、こんな暑い夏の日だった…。現在学生の人はもちろん、 
かつて学生だった人も、母校を思い浮かべながらプレイしてみてください。二 
部構成になっているので、ボリュームはあるかと。マルチエンデイングのため、 
すべての結末を見るのは大変ですが、クリアすると“おまけ”がありますの 
で、お楽しみに。 






( 文：『銀の盾』藍澤風樹） 
http://hp.vector.co.jp/authors/VA022686/ 

V _ _ _ _ ) 


馳0嫺や KAG シナリオのワンポイン I 


途中の選択肢により、物 
語はさまざまに分岐します 
が、共通イベントはサブル 
ーチンを使っています。そ 
のぶん、シナリオは分かり 
やすくまとめることができ 
ました。 

















鏞攀 



フアンタジツク•シヨートシヨートノベル『最後の夏 


「最後の夏」は、失踪した猫をめ 
ぐって繰り広げられるファンタジック 
なショートショートで、ゲーム要素は 
いっさいありません。 

「パソコンで 読む小説」を意識して 
作りました。縦書きの明朝体を採用し 
ていたり、右半分のみに文字表示ウイ 
ンドウをかぶせているのも、ウインド 
ウを本に見立てたからです。左側はさ 
し絵の部分というわけです。 

サウンド ノベルと 呼ばれるゲームでは、インタ ラクテイ ブ感を高めるために、 
「主人公が見ている映像」または r 主人公をとらえた カメラの 映像」を表示す 
る場合がほとんどだと思います。挿絵方式は、独特といえばいえるかもしれま 
せん。続く 「ガラスの 中の少女」では、さらにイメージ映像に近いものが多用 
されることになります。 

瀉出の見所や KAG シナリオのワンポイント 

「吉里古里1 /KAG 2」のスクリプ 
卜だということで、今回シナリオ•フ 
ァイルは CD への収録を見送らせてい 
ただきました。 

ほとんどが基本機能のみで、テクニ 
ック的にもあまり凝ったことはしてい 
ません。強いていえば冒頭の、文字が 
浮かび上がってくるところくらいでし 
よつか 。 [current layer =" messagel M 
withback = true 】 という状態で [ delayspeed =” nowait M 】 に設定して文章を記述、こ 
のレイヤのトランジション処理を行います。 

次に、 [ ct ] でメッセージ • レイヤー0 にフォーカスを戻し、先ほどと同じ文 
章を記述した後 、 [layopt layer = M messagel ,f page = ?, fore M visible = f , false "] にして 
います。これを繰り返して、1行ずつ増やした文章を順次表示していっている 
わけです。 


収録作品紹介 




(文：『林檎坂通信』管理人 SUZUNE ) 
http://www2.odn.ne.jp/suzune/ 
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コマンド選択式アドベンチャー『夢の終わり』 


アドベンチャーゲームと 言えば、 

昔は「見る」「調べる」などのコマ 
ンドを選んで進めていく形式がほと 
んどでしたが、最近はあまり見掛 
けません。それなら、自分で作っ 
てしまおうということで、昔懐かし 
い形式で制作しました。 

永遠の刻を生きる、ラルクとい 
う名の美しい吸血鬼がいる。彼は 
退屈と停滞を嫌い、旅を続けてい 
た。不老不死の彼を今宵待ち受けるは、死の臭いに満ちた村と、朽ちた教会 
で祈り続けるシスター。夢を見ていた者は誰？その望みは…？ 



馳の獅や KAO シナ时のクンポイント 



コマン ドの表示は マクロで メツ 
セージ • レイヤーの雛形を作って 
おき、通常メッセージ表示時と 
切り替えて使っています。 

これに限らず、同じ形式を多 
用するときはマクロを活用すると 
とても便利ですよ。 フレーム 内 
画像の表示位置も、マクロで設 
定しました。 


(文：『銀の盾』藍澤風樹） 


http://hp.vector.co.jp/authors/VA022686/ 
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「吉里吉里/ KAG 推進委員会」 （以下、 「委員会」）は、吉里吉里/ KAG ユー 
ザ ーが集うインターネット上のコミュニティで、 吉里吉里/ KAG の 開発者であ 
る W . Dee さんが正式に認可し、ほぼ常駐してくださっています。ですが、開 
発 者の W . Dee さんにはできるだけ吉里吉里/ KAG の 開発に専念してもらいたい 
という 理由から、 サイトの 管理は私 （P I A 少尉） が不肖ながら務めさせて 
いただいています。 

現在の委員会サイトはユーザーの皆さんが質問や意見を書き込める掲示板や、 
作った作品を告知するための自由登録リストなど、「参加型」のコンテンツが 
中心になっています。 

このように当委員会は、開発者である W . Dee さんに認可いただいた唯一の 
支援系公式サイトとして、吉里吉里/ KAG 本体や、吉里吉里/ KAG によって 制 
作された作品に関する情報の一元化を目指しています。 

現在のところ、当委員会は以下の4つの目的のために存在しています。_ 

① 吉里吉里/ KAG に関する各種情報の告知場所として 

② 同ツールを使う制作者のスキルアップの場として 

③ エンドユーザーと開発者の相互連絡の場として 

④ エンドユーザー同士の情報交換の場として 


吉里吉里/ KAG を使って何かを作ろうと考えている方は、ぜひ委員会へご参 
加ください。ネット上の最低限のマナーが守れる方ならどなたでもご参加いた 
だけますので、吉里吉里/ KAG に興味があるけど何が何だか分からない方から、 
吉里吉里/ KAG で制作した作品を告知したい方まで、自由にご利用ください。 

なお、当委員会には参加のための面倒な手続きや審査などは一切ありませ 
んし、それよりも何よりも、入会や退会などの概念すら存在しません。ご自分 
が「ぼくは推進委員だ！」と自己表明した瞬間から、あなたは推進委員です。 
詳細については下記のサイトをご覧ください。 


吉里吉里/ KAG 推進委員会 
http://www.piass.com/kpc/ 
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演算子一 K 



関数呼び 
出しなど 


単項演算子 
など麵 


演算子 L 使い方 


後置++ a ++ 


後置一 a- 


int 

real 

string 

前置！ 


⑻ 

演算の優先順位の変更 

a () 

1 関数 a を呼び出す 

a[b] 

1オブジェクト a のメンバ匕に 

アクセス(間接メンバ選択） 

a_b 

オブジェクト a のメンバ b に 

アクセス(直接メンバ指定） 

a++ 

a に 1 を足す（式全体としては 

演算前の値を示す） 

a- 

a から 1 を引く（式全体として 

は演算前の値を示す） 

a! 

a の表わす文字列を式として評価 

| 

a incontextof b 

1 

a のコンテキストオブジェク 

卜を b に変えたもの 

1 

int a 

a を整数型に変換 

real a 

a を実数型に変換 

string a 

a を文字列型に変換 

!a 

a の真偽を否定 


のビットを反転 


前置++ 

++a 

a に 1 を足す（式全体とし 

ては演算後の値を示す） 

前置-- 

—a 

a から 1 を引く《式全体と 

しては演算後の値を示す） 

new 

new a() 

クラス a のオブジェクトを 

作成する 

invalidate 

invalidate a 

1 オブジ I ク ha を無効化する 

isvalid 

isvalid a または 

オブジェクト a が有効ならば 

a isvalid 

“真，， 










演算子一轚 

r ■：■!： ベ 


単項滇算子 

など 

delete 

delete a 

変数またはメンバ a を削除 

typeof 

typeof a 

a の型を調べる 

# 

#a 

a の文字コード 

$ 

$a 

a のコードが表す文字 

単項+ 

+a 

a を数値型にする 

単項- 

-a 

a の正負を逆にする 

単項* 

*a 

ブロパティオブジェクト a 

にアクセス 

instanceof 

a instanceof b 

a がクラス b のオブジェク 

卜 ならば“ 真” 

乗除余算 
演算子 

% 

a% b 

a を b で割ったあまり 

/ 

a/b 

a を b で割る（値は実数として 

扱われる） 

¥ 

a¥b 

a を b で割る（値は整数と 
して扱われる） 

★ 

a*b 

a と b をかける 

加滅算 

演算子 

+ 

a + b 

a と b を加算（文字列に対して 

は結合} 

- 

a - b 

a から b を減算 

ビットシフト 

演算子 

» 

a » b 

a を b 回右に算術シフト 

(符号ビットを保つ） 

« 

a « b 

a が b 回左にシフト 

»> 

a »> b 

a を b 回右に論理シフト 
(上位ビットを 0 で埋める） 
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演算子一轚 

\'ぃ . ノ...い、着:::: ■ '： ; ../ 薫讓!議_ 
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••'. , >, パ 、.，：---'. 

\ ■< . v . ' •• • 

' " % 

" - -:. . : 

比較演算子 

く.：.へ:…ぐ:.....：.：...ど：..:... 

..二.'...ハ 

マ' 

■ .. ■. -.'.… 

< 

a < b 

a が b より小さければ“真” 

> 

a > b 

a が b より大きければ“真” 

<= 

a <= b 

a が b と同じか、あるいは 

a が b より小さければ"真” 

>= 

a >= b 

a が b と同じか、あるいは 

a が b より大きければ“真” 

. - 、 .二 u.：v .V . . へ.::...: 

， . - <», ■-■-: 

V . V 办 . ブ. .-♦4 V . へ'. 

:侧も孫.::が/ 

ぃ へ 

獨定嫌寡子 

.• _ . ' - .ぐ ■ V •- ■ - - ■ ' . 

== 

a == b 

a と b の値が同じならば“真” 

!= 

a != b 

a と b の値が異なれば“真” 

=== 

a === b 

a と b の型と値が同じならば“真” 

、•、., ■ •、::•、•,•、' .へ::：二..:•.マニぐ.:フ_ ••' 

漏:遍:擊^ 

!== 

a !== b 

a と b の型が異なるか、あるい 

は値が異なれば“真” 

ビット AND 

雄簠ネ，:二卜 

& 

a&b 

a と b のビットごとの AND 

(論理積） 

::靡が;：^: _ R :: 

演算子 

A 

a A b 

a と b のビットごとの XOR 

(排他的論理和） 

ビット OR 

旗算子 

1 

a | b 

a と b のビットごとの OR 

(論理和） 

細 AND 

演算子 

&& 

a&&b 

a が“真”かつ b が“真”なら 

ば“真，， 

論理 OR 

演算子 

II 

allb 

a が“真”または b が“真” 

ならば“真” 
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優先順位は、上にあげたものほど高く 
優先順位は同じです。 


演 II 子一鼸. 
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rKAGj と rxjsj . いかがでしたでしようか。 
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この本では KAG と TJS の基本を学ぶことができたと思います。「基本的」というのはどう 
いうことかというと、 KAG も TJS も応用範囲が広く、考えつく限りにしても、応用的なこと 
をすベて紹介するとなると、膨大な量になってしまいます。しかしながら、今回執筆させて頂 
いた内容は、吉里吉里、そして KAG と TJS のエッセンスを伝えるには充分であると思います。 

知れば知るほどに応用は広がりますが、同時にさらに知りたい部分も増えてくるかと思い 
ます。この本を読まれた方々は、吉里吉里/ KAG の世界をもっと知りたいと思うようになる 
と思います。この本に書かれていない多くの情報は、吉里吉里/ KAG の SDK (ソフトウェア開 
発キット）付属のドキユメントに書かれています。インターネット上の検索エンジンも役に立 
つでし上う 

' ノ又しよ::フ :〇ン Y ......二''. ' 

また、今回 CD - ROM 1 こ収録させていなだ I ゝた作品の申には、そのソースを閲覧できるもの 
があります。他の人の作品をよぐ研究することも、より深い理解につなが5良い方法だと思 

'.ぃます。:\施 ' ; ::麵 

「吉里吉里/ KAG 推進委員■もぜひご利用ぐだざ⑷インターネット上にある講座の自 
動登録リストがあります。掲示板にお越しいただいて、質問すれば、きっと答えが返ってく 
ると思ぃます。 

これらの環境は、吉里吉里/ KAG をサボートする多くの霧々によってつく 6 れたものです。 

「謝辞」にも書 V 嫌通りですが、再度感謝申し i げたいと思います。 

:::::ド:::.''::ぐ:':':''…:基 SS :: ド，一，）'::.”け::^ ________ 111 


吉里吉里/ KAG は ソフトウェアのソースが 衮閬されて又 ゝ ます。 ソース を公麗することによ 
り、ほかの開発者の方々のご意見を広く募ることができたり、あるいは実際に開発に参加し 
ていただくと0うことが可能になります。また、ラ”ス公開を前提とするプねグラミングで 
はい t ゝ加減なことはかけません。必然的にプログラムをきれいに書こうという意識を、自分 
を含めた開発者自身にもたせることができ、結果的により良い ソフトウェア 作りにつなが っ 
ていくのだと思います。'::ぐ K く.. 

' ' 乂 へ： へ..::，:。べ::ヤ.. ぃ. '-■'：：：- ■：■ 

吉里吉里は発展途上のソフトウェアです。日々改良、機能追加が行なわれています。これ r 

は作者の力の続く限り続けていぎたいものでず。どうぞ、皆様の暖かいご支援を引き続き賜 
りたく、お願い申し上げます。 

. 

2003 年 S 月吉日 W.Dee 
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思 US こせば 1 999年の12月。 


軽い気持ちでダウンロー ドした吉里吉里のサンプルに衝撃を受け、こんなすごいツールを 
制作しているのはどんな人なのだろうとサイトを訪問させていただいたところ、おや、と思 
える一文を発見しました。 _ _ 一 

1999/8/24 進埗 

なんか、吉里吉里本体は開発が止まっているというか、なんというか。使って 
くださっている人からのレスポンスが今のところ皆無に等しいので(泣） 

モニタに向かって「こんなすごいソフトなのになぜだ!?」と声に出して叫んだ自分は、「こ 


のままではいかん」と焦りました。4ヶ月も前の発言でこの状態では、すでに開発者のモチ 
ベーションがどん底まで落ちており、ひっそりと闇葬られてVまっているかもしれぬ。メ 
ールを出そうレ出して、ここに一人でも応援している人間がいるごとを伝えねば! 

——と、ごんな経捧戈衡動_にさんに初メール^ 

FKAG と心中」人生は始まったのであります。 

:?:匕:.：::::;111111111：： ; ：；；；；. 蒙:: - ______ P 5 S :: : 曙 1 : 

• - . ， • • • • •. . .ぐ-、... _ . 

本書にも書力せXもらいまレたが、このソフトは「これをしたい」という要求のほとんどに応 
じてぐれます。最初に敷居をまたぐだけの努力さえすれぼ、あとはどんどん手に顧I染んできま 
す。アドベンチャーやノベルだけではなぐ V シミ立レーションゲームやバズルなどはもちろん、 
プレゼンテーション*スライドや学習教材などにも_広ぐ利用できます。私自身、それほど 
使いこなしているわけではないのがお恥ずかしいのですが、このソフトを学習される方のため 
に必死になって書 t ゝた本なので、本書の内容が少しでも皆様のお役に立てたち嬢しいです。 


最後に、この場をお借りしてこの本を世に出すためにご協力いただ t ゝた皆様への謝辞を述 
ベさせていただきます。共著に私のような1ユーザーを抜擢して下さった寶里吉里/ KAG 開 
発者の W.Dee 様、本稿内の立ち絵や背景 CG のみならずソースレベルの作品を快ぐご提供く 
ださった IssisFactoy の吉田神一様と『地球のあくび J のうにゅ〜様、ダースレベルでの収 
録をご快諾下さった京秋人棣、朝から炒飯様、グロァ様、作品収録めご協方をいただいた藍 
澤風_、 SUZU_、 東様' 陽炎様、コミネト様、素材を提供 L てくださった Dauge 様、 
お世話になった吉里吉里/ KAG 推進委員会の皆様、每晚遅くまで原稿を書く自分の心身を支 
えてくれた我が妻、そしてこの本を手に取って下さ，たあなた。 

本当にありがとうございました。 

. ^ ^ ^003年5月吉日 PIA 少尉 
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2003年5月吉日 RA 少尉 
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W.Dee 

本業はソフトウェア開発。 C/C++ や Perl、PHP を操る。 

趣味はフリーソフト作り。吉里吉里もそんなフリーソフトの一つで、最初のバージョンを公開してから4年。 
もともとは自分たちでなんか一本ゲームでも作ろうとしていて、じゃあなにかここで永く使える沉用的なも 
のを作っておこうと思ったら、システム • ブログラムだけが一人歩きして現在にいたる。 
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② ft 復ばがき、 

③ FAX_52_031 
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④ Bmail iomook @ kdh9akusha .€ o,jp 

のいずれかで、工学社第二 I / O 編集部宛にお願いします 
電話によるお問い合わせはご遠慮ください。 
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